Desktop Commander

Desktop Commander — MCP-сервер сообщества (автор — wonderwhy-er). Desktop Commander: команды терминала, операции с файлами и управление процессами. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
wonderwhy-er
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
linux, macos, windows
Языки
javascript

Уровень риска: high

Полный доступ к терминалу и файлам; по README это не песочница — ограничения папок и команд обходятся. `allowedDirectories` не ограничивает терминал. Для изоляции используйте Docker; телеметрия отключается `"telemetryEnabled": false`.

Настройка клиентов

codex
{
    "code": "[mcp_servers.desktop-commander]\ncommand = \"npx\"\nargs = [\"-y\", \"@wonderwhy-er/desktop-commander@latest\"]",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Desktop Commander MCP даёт ИИ-ассистенту доступ к терминалу и файлам вашего компьютера. Ассистент запускает команды, в том числе долгие, управляет процессами, ищет и правит файлы. Сервер вырос из эталонного Filesystem MCP и добавил к нему работу с терминалом, Excel, PDF и Word.

  • Терминал: запуск программ с потоковым выводом, работа с запущенными процессами (SSH, базы данных, dev-серверы), таймауты и фоновый режим, список и остановка процессов.
  • Файлы: чтение и запись, в том числе по URL, создание папок, рекурсивный список с ограничением глубины, перемещение, метаданные, чтение с конца файла как tail.
  • Поиск: потоковый поиск по именам и содержимому на базе ripgrep, включая содержимое Excel.
  • Правка кода: точечные замены текста (edit_block), полная перезапись, замены по шаблону.
  • Документы: чтение, запись и поиск в Excel (.xlsx, .xls, .xlsm), PDF с извлечением текста и созданием из markdown, документы DOCX.
  • Выполнение кода в памяти на Python, Node.js и R без сохранения файлов, быстрый анализ CSV, JSON и Excel.
  • Журнал вызовов хранится локально и доступен через get_recent_tool_calls.

Настройки меняются на лету через get_config и set_config_value: разрешённые папки, запрещённые команды, оболочка по умолчанию.

Кому подойдёт

  • Разработчику, который хочет, чтобы ассистент в Claude Desktop запускал сборку, тесты и dev-сервер, читал логи и правил код.
  • Аналитику: «проанализируй этот CSV» или «найди строки в Excel» без отдельных инструментов.
  • Тем, кто работает с документами: правка Word и PDF, сборка PDF из markdown.

Другие варианты — в категориях разработка и файлы и документы.

Установка

Для Claude Desktop самый быстрый способ — команда настройки, она сама пропишет сервер в конфиг:

npx @wonderwhy-er/desktop-commander@latest setup

Удаление: npx @wonderwhy-er/desktop-commander@latest remove. Есть и другие варианты: скрипт для macOS, Smithery, ручная запись в конфиг, сборка из исходников и Docker-образ mcp/desktop-commander для полной изоляции. Нужен Node.js, кроме варианта с Docker.

Подключение к клиентам

Команды и конфиги приведены дословно из README. Для Cursor README предлагает тот же стандартный JSON в ~/.cursor/mcp.json или .cursor/mcp.json. Общий порядок — в инструкции как подключить MCP.

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

Для Codex есть и команда codex mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest.

Проверка

Попросите ассистента показать текущую конфигурацию Desktop Commander. Он вызовет get_config. Затем попросите вывести список файлов в рабочей папке — сработает list_directory.

Инструменты

Инструмент Что делает Доступ
read_file, list_directory Чтение файлов и папок чтение
start_search Поиск по именам и содержимому чтение
get_recent_tool_calls Журнал последних вызовов чтение
write_file, edit_block Запись и точечная правка запись
write_pdf Создание и изменение PDF запись
start_process, interact_with_process Запуск команд и работа с процессами запись
kill_process Остановка процесса запись
set_config_value Изменение настроек сервера запись

Примеры задач

Запусти тесты проекта, найди упавшие и исправь код.
Проанализируй sales.xlsx: выручка по месяцам и топ-10 клиентов.
Собери PDF из README.md с оглавлением.

Риски

Это полный доступ к терминалу и файлам вашего пользователя. README честно пишет: защитные механизмы — не песочница. Ограничение папок и список запрещённых команд можно обойти через символические ссылки, подстановку команд и абсолютные пути. allowedDirectories ограничивает только файловые операции, но не команды терминала, а пустой список открывает всю файловую систему.

Как снизить риски: для изоляции используйте Docker-вариант, меняйте настройки в отдельном чате (README предупреждает, что ассистент может сам попытаться изменить allowedDirectories), проверяйте команды перед запуском. Сервер собирает псевдонимную телеметрию без содержимого файлов, путей и аргументов команд, отключается настройкой "telemetryEnabled": false. Лицензия — MIT.

Частые вопросы

Можно ли ограничить доступ к папкам?

Частично. allowedDirectories ограничивает файловые операции, но не команды терминала. Для настоящей изоляции README советует Docker.

Собирает ли сервер данные?

Да, ограниченную псевдонимную телеметрию без содержимого файлов, путей и аргументов. Отключается через "telemetryEnabled": false.

Работает ли не только с Claude Desktop?

Да. README даёт настройки для Claude Code, Cursor, Codex, VS Code, Windsurf и других клиентов.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • read_file
  • list_directory
  • start_search
  • get_recent_tool_calls
  • write_file
  • edit_block
  • write_pdf
  • start_process
  • interact_with_process
  • kill_process
  • set_config_value

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

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники