Desktop Commander MCP
wonderwhy-er/DesktopCommanderMCPMCP-сервер для Claude, предоставляющий полный контроль над терминалом, файловой системой и редактированием кода. Поддерживает Excel, PDF, DOCX, выполнение кода в памяти, интерактивное управление процессами и поиск по содержимому файлов.
Подключение
claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latestREADME
Desktop Commander MCP
Поиск, обновление, управление файлами и выполнение команд терминала с помощью AI
Работа с кодом и текстом, запуск процессов и автоматизация задач — возможности, далеко выходящие за рамки других 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-клиентами — приложение для тех, кто хочет выделенный, отполированный опыт.
Содержание
- Возможности
- Установка
- Начало работы
- Использование
- Предпросмотр файлов и редактор Markdown
- Работа с долгими командами
- Дорожная карта
- Спонсоры и поддержка
- Сайт
- Медиа
- Отзывы
- Часто задаваемые вопросы
- Участие в разработке
- Лицензия
Все инструменты 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
- Клонируйте репозиторий:
git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup
Или установите через npm:
npm install -g @wonderwhy-er/desktop-commander
- Перезапустите Claude Desktop.
Обновление вручную:
npm update -g @wonderwhy-er/desktop-commander
Для изолированного выполнения в Docker-контейнере без установки Node.js:
- Убедитесь, что Docker установлен и запущен
- Выполните:
docker run --rm wonderwhyer/desktop-commander setup
Это настроит Claude Desktop на использование Docker-версии с автоматическими обновлениями.
Примечание по безопасности: Docker-вариант обеспечивает дополнительную изоляцию — команды выполняются внутри контейнера. Подробности в SECURITY.md.
Установка в другие MCP-клиенты
Добавьте в настройки MCP Cursor:
{
"mcpServers": {
"desktopCommander": {
"command": "npx",
"args": ["-y", "@wonderwhy-er/desktop-commander"]
}
}
}Добавьте в конфигурацию MCP Windsurf:
{
"mcpServers": {
"desktopCommander": {
"command": "npx",
"args": ["-y", "@wonderwhy-er/desktop-commander"]
}
}
}Используйте Desktop Commander из ChatGPT, Claude web и других AI-сервисов без локальной установки:
Подключитесь к удалённому 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-файлы прямо в интерфейсе
- Открыть в папке — быстрый доступ к файлу в файловом менеджере
Работа с долгими командами
Для команд, которые выполняются долго (серверы, сборки и т.д.):
- Команда запускается и возвращает
pidсессии - Используйте
read_outputс этимpidдля получения вывода - Используйте
force_terminateдля остановки при необходимости
Пример:
Запусти: npm run dev
[возвращает pid: 12345]
Прочитай вывод сессии 12345
Дорожная карта
- Улучшенная интеграция с браузером
- Поддержка дополнительных форматов файлов
- Расширенное управление процессами
- Система навыков
- Фоновые задачи по расписанию
Поддержка Desktop Commander
Если Desktop Commander оказался вам полезен, поддержите проект:
Сайт
Медиа
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