Claude Info
Dev-инструменты

Desktop Commander MCP

wonderwhy-er/DesktopCommanderMCP

MCP-сервер для Claude, предоставляющий полный контроль над терминалом, файловой системой и редактированием кода. Поддерживает Excel, PDF, DOCX, выполнение кода в памяти, интерактивное управление процессами и поиск по содержимому файлов.

Подключение

terminal
bash
claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

README

Desktop Commander MCP

Поиск, обновление, управление файлами и выполнение команд терминала с помощью AI

npm downloads AgentAudit Verified Trust Score smithery badge Buy Me A Coffee

Discord

Работа с кодом и текстом, запуск процессов и автоматизация задач — возможности, далеко выходящие за рамки других AI-редакторов, при этом используются подписки хост-клиента вместо затрат на API-токены.

👋 Мы нанимаем — присоединяйтесь: https://desktopcommander.app/careers/

🖥️ Попробуйте Desktop Commander App (Бета)

Хотите лучший опыт? Desktop Commander App предоставляет всё то же, что и MCP-сервер, плюс:

  • Любая AI-модель — Claude, GPT-4.5, Gemini 2.5 или любая другая
  • Просмотр изменений файлов в реальном времени — визуальный предпросмотр по мере редактирования
  • Добавление собственных MCP и контекста — расширяйте инструментами без конфигурационных файлов
  • Скоро — система навыков, диктовка, фоновые задачи по расписанию и многое другое

👉 Скачать приложение (macOS и Windows)

MCP-сервер по-прежнему отлично работает с Claude Desktop и другими MCP-клиентами — приложение для тех, кто хочет выделенный, отполированный опыт.

Содержание

Все инструменты AI-разработки в одном месте. Desktop Commander объединяет все инструменты разработчика в одном чате. Выполняйте долгие команды терминала на своём компьютере и управляйте процессами через Model Context Protocol (MCP). Построен на основе MCP Filesystem Server с дополнительными возможностями поиска и замены в файлах.

Возможности

  • Удалённое управление через AI — используйте Desktop Commander из ChatGPT, Claude web и других AI-сервисов через Remote MCP
  • Предпросмотр файлов — визуальный просмотр в Claude Desktop с рендерингом Markdown, встроенными изображениями, раскрываемым содержимым, встроенным редактором Markdown и быстрым доступом «Открыть в папке»
  • Расширенные команды терминала с интерактивным управлением процессами
  • Выполнение кода в памяти (Python, Node.js, R) без сохранения файлов
  • Мгновенный анализ данных — просто попросите проанализировать CSV/JSON/Excel-файлы
  • Нативная поддержка Excel — чтение, запись, редактирование и поиск в файлах Excel (.xlsx, .xls, .xlsm) без внешних инструментов
  • Поддержка PDF — чтение PDF с извлечением текста, создание новых PDF из Markdown, изменение существующих PDF
  • Поддержка DOCX — чтение, создание, редактирование и поиск в документах Word (.docx) с точечным XML-редактированием и конвертацией Markdown в DOCX
  • Взаимодействие с запущенными процессами (SSH, базы данных, серверы разработки)
  • Выполнение команд терминала с потоковым выводом
  • Поддержка таймаута команд и фонового выполнения
  • Управление процессами (список и завершение процессов)
  • Управление сессиями для долгих команд
  • Постраничный вывод процессов — чтение вывода терминала с управлением смещением/длиной для предотвращения переполнения контекста
  • Управление конфигурацией сервера:
    • Получение/установка значений конфигурации
    • Обновление нескольких настроек одновременно
    • Динамическое изменение конфигурации без перезапуска сервера
  • Полноценные операции с файловой системой:
    • Чтение/запись файлов (текст, Excel, PDF, DOCX)
    • Создание/просмотр директорий
    • Рекурсивный листинг директорий с настраиваемой глубиной и защитой от переполнения контекста для больших папок
    • Перемещение файлов/директорий
    • Поиск файлов и содержимого (включая содержимое Excel)
    • Получение метаданных файлов
    • Чтение файла с отрицательным смещением: чтение с конца файла с использованием отрицательных значений смещения (аналог Unix tail)
  • Возможности редактирования кода:
    • Точечная замена текста для небольших изменений
    • Полная перезапись файла для масштабных изменений
    • Поддержка нескольких файлов
    • Замена по шаблону
    • Рекурсивный поиск кода или текста в папках на основе vscode-ripgrep
  • Полноценное журналирование:
    • Автоматическая запись всех вызовов инструментов
    • Ротация логов с ограничением 10 МБ
    • Подробные временны́е метки и аргументы
  • Усиление безопасности:
    • Защита от обхода символических ссылок при файловых операциях
    • Блок-лист команд с защитой от обхода
    • Изоляция Docker для полной песочницы
    • Подробности в SECURITY.md

Установка

Установка в Claude Desktop

Desktop Commander предлагает несколько способов установки для Claude Desktop.

📋 Обновление и удаление: Варианты 1, 2, 3, 4 и 6 поддерживают автоматические обновления. Вариант 5 требует обновления вручную.

Просто выполните в терминале:

npx @wonderwhy-er/desktop-commander setup

Затем перезапустите Claude Desktop.

Если у вас установлен Claude Code, выполните:

claude mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander

Для автоматической установки через Smithery:

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude npx mcp-get install @wonderwhy-er/desktop-commander
  1. Клонируйте репозиторий:
git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git cd DesktopCommanderMCP npm run setup

Или установите через npm:

npm install -g @wonderwhy-er/desktop-commander
  1. Перезапустите Claude Desktop.

Обновление вручную:

npm update -g @wonderwhy-er/desktop-commander

Для изолированного выполнения в Docker-контейнере без установки Node.js:

  1. Убедитесь, что Docker установлен и запущен
  2. Выполните:
docker run --rm wonderwhyer/desktop-commander setup

Это настроит Claude Desktop на использование Docker-версии с автоматическими обновлениями.

Примечание по безопасности: Docker-вариант обеспечивает дополнительную изоляцию — команды выполняются внутри контейнера. Подробности в SECURITY.md.

Установка в другие MCP-клиенты

Добавьте в настройки MCP Cursor:

json
{
  "mcpServers": {
    "desktopCommander": {
      "command": "npx",
      "args": ["-y", "@wonderwhy-er/desktop-commander"]
    }
  }
}

Добавьте в конфигурацию MCP Windsurf:

json
{
  "mcpServers": {
    "desktopCommander": {
      "command": "npx",
      "args": ["-y", "@wonderwhy-er/desktop-commander"]
    }
  }
}

Используйте Desktop Commander из ChatGPT, Claude web и других AI-сервисов без локальной установки:

👉 mcp.desktopcommander.app

Подключитесь к удалённому MCP-серверу и управляйте своим компьютером из любого AI-интерфейса.

Начало работы

После установки попробуйте следующие команды в Claude Desktop:

  • «Покажи содержимое моего рабочего стола»
  • «Найди все JavaScript-файлы в моей домашней директории»
  • «Запусти npm test в моём проекте»
  • «Проанализируй этот CSV-файл и покажи статистику»

Использование

Команды терминала

Desktop Commander позволяет выполнять команды терминала с полным управлением процессами:

Выполни: ls -la ~/Documents Запусти сервер разработки: cd my-project && npm start Проверь запущенные процессы: ps aux | grep node

Операции с файлами

Прочитай файл: ~/projects/app.js Создай новый файл с таким содержимым... Найди все файлы, содержащие 'TODO' в ~/projects

Анализ данных

Проанализируй ~/data/sales.csv и покажи итоги по месяцам Открой ~/reports/data.xlsx и найди строки, где продажи > 1000

Предпросмотр файлов и редактор Markdown

Desktop Commander включает UI для предпросмотра файлов в Claude Desktop:

  • Рендеринг Markdown — просматривайте отформатированный Markdown прямо в чате
  • Встроенные изображения — изображения отображаются inline
  • Раскрываемое содержимое — большие файлы можно сворачивать
  • Встроенный редактор Markdown — редактируйте Markdown-файлы прямо в интерфейсе
  • Открыть в папке — быстрый доступ к файлу в файловом менеджере

Работа с долгими командами

Для команд, которые выполняются долго (серверы, сборки и т.д.):

  1. Команда запускается и возвращает pid сессии
  2. Используйте read_output с этим pid для получения вывода
  3. Используйте force_terminate для остановки при необходимости

Пример:

Запусти: npm run dev [возвращает pid: 12345] Прочитай вывод сессии 12345

Дорожная карта

  • Улучшенная интеграция с браузером
  • Поддержка дополнительных форматов файлов
  • Расширенное управление процессами
  • Система навыков
  • Фоновые задачи по расписанию

Поддержка Desktop Commander

Если Desktop Commander оказался вам полезен, поддержите проект:

Buy Me A Coffee

Сайт

https://desktopcommander.app

Медиа

Desktop Commander упоминался в различных публикациях и видео об AI-инструментах для разработчиков.

Отзывы

Пользователи отмечают, что Desktop Commander значительно ускоряет рабочий процесс, позволяя выполнять сложные задачи через естественный язык.

Часто задаваемые вопросы

Нужен ли Node.js? Для вариантов 1–5 — да. Вариант 6 (Docker) не требует Node.js.

Безопасно ли это? Desktop Commander включает несколько уровней защиты. Подробности в SECURITY.md.

Работает ли с другими AI, кроме Claude? Да, через Remote MCP можно использовать с ChatGPT, Claude web и другими сервисами.

Участие в разработке

Пулл-реквесты приветствуются! Пожалуйста, ознакомьтесь с CONTRIBUTING.md перед началом работы.

Лицензия

MIT

Похожие MCP-серверы