Desktop Commander MCP

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

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

🖥️ Попробуйте приложение Desktop Commander (Бета)

Хотите лучший опыт? Приложение Desktop Commander предлагает всё, что делает MCP-сервер, а также:

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

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

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

Содержание

• Возможности
• Как установить
• Начало работы
• Использование
• Интерфейс предпросмотра файлов и Markdown-редактор
• Обработка долговременных команд
• В разработке и планы
• Спонсоры и сторонники
• Веб-сайт
• СМИ
• Отзывы
• Часто задаваемые вопросы
• Участие в разработке
• Лицензия

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

Возможности

• Удалённое управление ИИ - Используйте Desktop Commander из ChatGPT, Claude web и других ИИ-сервисов через 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
• Подробное аудит-логирование:
• Автоматическое логирование всех вызовов инструментов
• Ротация логов с ограничением размера 10MB
• Детальные временные метки и аргументы
• Усиление безопасности:
• Предотвращение обхода символических ссылок при операциях с файлами
• Блок-лист команд с защитой от обхода
• Изоляция через Docker для полной песочницы
• Подробности смотрите в SECURITY.md

Как установить

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

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

📋 Информация об обновлении и удалении: Варианты 1, 2, 3, 4 и 6 имеют автоматические обновления. Вариант 5 требует ручных обновлений. Подробности см. ниже.

Вариант 1: Установка через npx ⭐ Автообновления (Требуется Node.js)

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

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

Для отладочного режима (позволяет подключение инспектора Node.js):

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

Опции командной строки при установке: - --debug: Включение отладочного режима для инспектора Node.js - --no-onboarding: Отключение приветственных подсказок для новых пользователей

Перезапустите Claude, если он запущен.

✅ Автообновления: Да — автоматически обновляется при перезапуске Claude 🔄 Ручное обновление: Запустите команду установки снова 🗑️ Удаление: Запустите npx @wonderwhy-er/desktop-commander@latest remove

Вариант 2: Использование bash-скрипта установщика (macOS) ⭐ Автообновления (Устанавливает Node.js при необходимости)

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

Этот скрипт автоматически обрабатывает все зависимости и конфигурацию.

✅ Автообновления: Да 🔄 Ручное обновление: Повторно запустите команду bash-установщика выше 🗑️ Удаление: Запустите npx @wonderwhy-er/desktop-commander@latest remove

Вариант 3: Установка через Smithery ⭐ Автообновления (Требуется Node.js)

1. Перейдите по адресу: https://smithery.ai/server/@wonderwhy-er/desktop-commander
2. Войдите в Smithery, если ещё не сделали этого
3. Выберите ваш клиент (Claude Desktop) справа
4. Установите с помощью предоставленного ключа, который появится после выбора клиента
5. Перезапустите Claude Desktop

✅ Автообновления: Да — автоматически обновляется при перезапуске Claude 🔄 Ручное обновление: Перейдите на страницу Smithery и переустановите

Вариант 4: Ручное добавление в claude_desktop_config ⭐ Автообновления (Требуется Node.js)

Добавьте эту запись в ваш claude_desktop_config.json:

• На Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• На Windows: %APPDATA%\Claude\claude_desktop_config.json
• На Linux: ~/.config/Claude/claude_desktop_config.json

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

Перезапустите Claude, если он запущен.

✅ Автообновления: Да — автоматически обновляется при перезапуске Claude 🔄 Ручное обновление: Запустите команду установки снова 🗑️ Удаление: Запустите npx @wonderwhy-er/desktop-commander@latest remove или удалите запись из вашего claude_desktop_config.json

Вариант 5: Локальная установка из репозитория ❌ Ручные обновления (Требуется Node.js)

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

Перезапустите Claude, если он запущен.

Команда установки установит зависимости, соберёт сервер и настроит приложение Claude Desktop.

❌ Автообновления: Нет — требуются ручные обновления через git 🔄 Ручное обновление: cd DesktopCommanderMCP && git pull && npm run setup 🗑️ Удаление: Запустите npx @wonderwhy-er/desktop-commander@latest remove или удалите клонированный каталог и запись MCP-сервера из конфигурации Claude

Вариант 6: Установка через Docker 🐳 ⭐ Автообновления (Без необходимости Node.js)

Идеально для пользователей, которым нужна изоляция или у которых не установлен Node.js. Работает в изолированном Docker-контейнере с постоянной средой работы.

Предварительные требования: Установлен и запущен Docker Desktop, установлено приложение Claude Desktop.

macOS/Linux:

bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)

Windows PowerShell:

iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'))

Установщик проверит Docker, скачает образ, предложит смонтировать папки и настроит Claude Desktop.

Постоянство данных Docker: Ваши инструменты, конфигурации, рабочие файлы и кэши пакетов сохраняются после перезапусков.

**Ручная конфигурация Docker** **Базовая настройка (без доступа к файлам):**

{
"mcpServers": {
  "desktop-commander-in-docker": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "mcp/desktop-commander:latest"]
  }
}
}

**С монтированием папок:**

{
"mcpServers": {
  "desktop-commander-in-docker": {
    "command": "docker",
    "args": [
      "run", "-i", "--rm",
      "-v", "/Users/username/Desktop:/mnt/desktop",
      "-v", "/Users/username/Documents:/mnt/documents",
      "mcp/desktop-commander:latest"
    ]
  }
}
}

**Расширенное монтирование папок:**

{
"mcpServers": {
  "desktop-commander-in-docker": {
    "command": "docker",
    "args": [
      "run", "-i", "--rm",
      "-v", "dc-system:/usr",
      "-v", "dc-home:/root",
      "-v", "dc-workspace:/workspace",
      "-v", "dc-packages:/var",
      "-v", "/Users/username/Projects:/mnt/Projects",
      "-v", "/Users/username/Downloads:/mnt/Downloads",
      "mcp/desktop-commander:latest"
    ]
  }
}
}

**Команды управления Docker** **macOS/Linux:**

# Проверить статус
bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --status

# Сбросить все постоянные данные
bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --reset

**Windows PowerShell:**

# Проверить статус
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Status

# Сбросить все данные
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Reset

# Показать справку
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Help

**Устранение неполадок:** Сброс и переустановка с нуля:

bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --reset && bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)

**✅ Автообновления:** Да — тег `latest` автоматически получает более новые версии **🔄 Ручное обновление:** `docker pull mcp/desktop-commander:latest`, затем перезапустите Claude

Установка в других клиентах

Desktop Commander работает с любым MCP-совместимым клиентом. Стандартная JSON-конфигурация:

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

Добавьте это в файл конфигурации MCP вашего клиента по указанным ниже путям:

Cursor

Просмотреть MCP-сервер в каталоге

Или добавьте вручную в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в папке вашего проекта (для проекта).

Дополнительную информацию смотрите в документации Cursor MCP.

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json. Дополнительную информацию смотрите в документации Windsurf MCP.

VS Code / GitHub Copilot

Добавьте в .vscode/mcp.json в вашем проекте или в пользовательских настройках VS Code (JSON). Убедитесь, что MCP включен в разделе Chat > MCP. Работает в режиме Agent.

Дополнительную информацию смотрите в документации VS Code MCP.

Cline

Настройте через настройки расширения Cline в VS Code. Откройте боковую панель Cline, нажмите на значок MCP Servers и добавьте приведённую выше JSON-конфигурацию. Дополнительную информацию смотрите в документации Cline MCP.

Roo Code

Добавьте в ваш файл конфигурации MCP Roo Code. Дополнительную информацию смотрите в документации Roo Code MCP.

Claude Code

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

Уберите --scope user, чтобы установить только для текущего проекта. Дополнительную информацию смотрите в документации Claude Code MCP.

Trae

Используйте функцию «Добавить вручную» и вставьте приведённую выше JSON-конфигурацию. Дополнительную информацию смотрите в документации Trae MCP.

Kiro

Перейдите в Kiro > MCP Servers, нажмите + Add и вставьте приведённую выше JSON-конфигурацию. Дополнительную информацию смотрите в документации Kiro MCP.

Codex (OpenAI)

Codex использует TOML-конфигурацию. Выполните эту команду для добавления Desktop Commander:

codex mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

Или добавьте вручную в ~/.codex/config.toml:

[mcp_servers.desktop-commander]
command = "npx"
args = ["-y", "@wonderwhy-er/desktop-commander@latest"]

Дополнительную информацию смотрите в документации Codex MCP.

JetBrains (AI Assistant)

В IDE JetBrains перейдите в Settings → Tools → AI Assistant → Model Context Protocol (MCP), нажмите + Add, выберите As JSON и вставьте приведённую выше JSON-конфигурацию. Дополнительную информацию смотрите в документации JetBrains MCP.

Gemini CLI

Добавьте в ~/.gemini/settings.json:

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

Дополнительную информацию смотрите в документации Gemini CLI.

Augment Code

Нажмите Cmd/Ctrl+Shift+P, откройте панель Augment и добавьте новый MCP-сервер с именем desktop-commander с приведённой выше JSON-конфигурацией. Дополнительную информацию смотрите в документации Augment Code MCP.

Qwen Code

Выполните эту команду для добавления Desktop Commander:

qwen mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

Или добавьте в .qwen/settings.json (проект) или ~/.qwen/settings.json (глобально). Дополнительную информацию смотрите в документации Qwen Code MCP.

ChatGPT / Claude Web (Remote MCP)

Используйте Desktop Commander из ChatGPT, Claude web и других ИИ-сервисов через Remote MCP — приложение для настольного ПК не требуется.

👉 Начните работу на mcp.desktopcommander.app

Как это работает: 1. Вы запускаете лёгкое Удалённое устройство на вашем компьютере 2. Оно безопасно подключается к облачному сервису Remote MCP 3. Ваш ИИ отправляет команды через облако на ваше устройство 4. Команды выполняются локально, результаты возвращаются вашему ИИ 5. Вы остаетесь в контроле — остановите в любой момент с помощью Ctrl+C

Безопасность

• ✅ Устройство работает только при его запуске вами
• ✅ Команды выполняются под вашими правами пользователя
• ✅ Безопасная OAuth-аутентификация и зашифрованный канал связи

Обновление и удаление Desktop Commander

Автоматические обновления (Варианты 1, 2, 3, 4 и 6)

Вариант 1 (npx), Вариант 2 (bash-установщик), 3 (Smithery), 4 (ручная конфигурация) и 6 (Docker) автоматически обновляются до последней версии при каждом перезапуске Claude. Ручное вмешательство не требуется.

Ручные обновления (Вариант 5)

• Вариант 5 (локальная установка): cd DesktopCommanderMCP && git pull && npm run setup

Удаление Desktop Commander

🤖 Автоматическое удаление (Рекомендуется)

Самый простой способ полностью удалить Desktop Commander:

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

Этот автоматический деинсталлятор: - ✅ Удалит Desktop Commander из конфигурации MCP-сервера Claude - ✅ Создаст резервную копию вашей конфигурации Claude перед внесением изменений - ✅ Предоставит инструкции для полного удаления пакета - ✅ Восстановит из резервной копии, если что-то пойдёт не так

🔧 Ручное удаление

Если автоматический деинсталлятор не работает или вы предпочитаете ручное удаление:

Удаление из конфигурации Claude

1. Найдите файл конфигурации Claude Desktop:
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%\Claude\claude_desktop_config.json

4. Linux: ~/.config/Claude/claude_desktop_config.json

5. Отредактируйте файл конфигурации:

6. Откройте файл в текстовом редакторе
7. Найдите и удалите запись "desktop-commander" из раздела "mcpServers"
8. Сохраните файл

Пример — удалите этот раздел: json { "desktop-commander": { "command": "npx", "args": ["@wonderwhy-er/desktop-commander@latest"] } }

Закройте и перезапустите Claude Desktop для завершения удаления.

🆘 Устранение неполадок

Если автоматическое удаление не удалось: - Используйте ручное удаление в качестве альтернативы

Если Claude не запускается после удаления: - Восстановите файл резервной копии конфигурации, созданный деинсталлятором - Или вручную исправьте синтаксис JSON в вашем claude_desktop_config.json

Нужна помощь? - Присоединяйтесь к нашему сообществу в Discord: https://discord.com/invite/kQ27sNnZr7

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

После установки Desktop Commander и перезапуска Claude Desktop вы готовы улучшить свой опыт работы с Claude!

🚀 Ввод для новых пользователей

Desktop Commander включает умное введение, которое поможет вам узнать о возможностях:

Для новых пользователей: Когда вы только начинаете (менее 10 успешных команд), Claude будет автоматически предлагать полезные практические руководства и обучение после того, как вы успешно используете Desktop Commander.

Запрашивайте помощь в любое время: Вы можете запросить помощь с введением в любое время, просто сказав: - «Помоги мне начать использовать Desktop Commander» - «Покажи мне примеры Desktop Commander» - «Что я могу делать с Desktop Commander?»

Затем Claude покажет вам простые для понимания руководства и примеры, включая: - 📁 Автоматическая организация папки «Загрузки» - 📊 Анализ файлов CSV/Excel с помощью Python - ⚙️ Настройка GitHub Actions CI/CD - 🔍 Изучение и понимание кодовых баз - 🤖 Запуск интерактивных сред разработки

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

Сервер предоставляет комплексный набор инструментов, организованных в несколько категорий:

Доступные инструменты

Категория	Инструмент	Описание
Конфигурация	get_config	Получить полную конфигурацию сервера в формате JSON (включает blockedCommands, defaultShell, allowedDirectories, fileReadLineLimit, fileWriteLineLimit, telemetryEnabled)
	set_config_value	Установить определённое значение конфигурации по ключу. Доступные настройки: • blockedCommands: Массив команд оболочки, которые не могут быть выполнены • defaultShell: Оболочка для использования командами (например, bash, zsh, powershell) • allowedDirectories: Массив путей файловой системы, к которым сервер может обращаться для операций с файлами (⚠️ команды терминала по-прежнему могут обращаться к файлам за пределами этих каталогов) • fileReadLineLimit: Максимальное количество строк для чтения за раз (по умолчанию: 1000) • fileWriteLineLimit: Максимальное количество строк для записи за раз (по умолчанию: 50) • telemetryEnabled: Включение/выключение телеметрии (булево значение)
Терминал	start_process	Запуск программ с умным определением момента их готовности к вводу
	interact_with_process	Отправка команд запущенным программам и получение ответов
	read_process_output	Чтение вывода от запущенных процессов
	force_terminate	Принудительное завершение запущенной сессии терминала
	list_sessions	Список всех активных сессий терминала
	list_processes	Список всех запущенных процессов с подробной информацией
	kill_process	Завершение запущенного процесса по PID
Файловая система	read_file	Чтение содержимого из локальной файловой системы, URL-адресов, файлов Excel (.xlsx, .xls, .xlsm) и PDF с постраничной навигацией
	read_multiple_files	Одновременное чтение нескольких файлов
	write_file	Запись содержимого файла с опциями перезаписи или режима добавления. Поддерживает файлы Excel (формат JSON 2D массив). Для PDF используйте write_pdf