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`.
Настройка клиентов
{
"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.
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.