Skip to main content
Glama
Sign In
deenesjakoruzh

Claude Desktop Commander MCP

by wonderwhy-er
npmGitHub
TypeScript
MIT License
14,607
2,477
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Настольный командор MCP

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

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

Оглавление

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

Функции

  • Выполнение команд терминала с потоковой передачей данных
  • Поддержка тайм-аута и фонового выполнения команды
  • Управление процессами (составление списка и завершение процессов)
  • Управление сеансами для длительно выполняемых команд
  • Управление конфигурацией сервера:
    • Получить/установить значения конфигурации
    • Обновить несколько настроек одновременно
    • Динамические изменения конфигурации без перезапуска сервера
  • Полные операции с файловой системой:
    • Чтение/запись файлов
    • Создать/перечислить каталоги
    • Переместить файлы/каталоги
    • Поиск файлов
    • Получить метаданные файла
  • Возможности редактирования кода:
    • Хирургическая замена текста при небольших изменениях
    • Полная переписывание файлов для внесения существенных изменений
    • Поддержка нескольких файлов
    • Замены на основе шаблонов
    • рекурсивный поиск кода или текста в папках на основе vscode-ripgrep

Установка

Сначала убедитесь, что вы загрузили и установили приложение Claude Desktop , а также у вас установлен npm .

Вариант 1: Установка через npx

Просто запустите это в терминале:

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

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

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

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

Вариант 2: использование установщика скрипта bash (macOS)

Пользователи macOS могут воспользоваться нашим автоматизированным установщиком bash, который проверит версию Node.js, установит ее при необходимости и автоматически настроит Desktop Commander:

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

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

Вариант 3: Установка через Smithery

Чтобы автоматически установить Desktop Commander для Claude Desktop через Smithery :

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

Вариант 4: Добавить в claude_desktop_config вручную

Добавьте эту запись в ваш 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" ] } } }

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

Вариант 5: Оформить заказ на месте

  1. Клонировать и собрать:
git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git cd DesktopCommanderMCP npm run setup

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

Команда установки выполнит следующие действия:

  • Установить зависимости
  • Построить сервер
  • Настройте настольное приложение Клода
  • При необходимости добавьте MCP-серверы в конфигурацию Клода.

Обновление Desktop Commander

При установке через npx (вариант 1) или Smithery (вариант 3) Desktop Commander будет автоматически обновляться до последней версии при каждом перезапуске Claude. Ручной процесс обновления не требуется.

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

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

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

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

КатегорияИнструментОписание
Конфигурацияget_configПолучить полную конфигурацию сервера в формате JSON (включая blockedCommands, defaultShell, allowedDirectories)
set_config_valueУстановите определенное значение конфигурации по ключу. Доступные настройки: • blockedCommands : Массив команд оболочки, которые не могут быть выполнены• defaultShell : Оболочка, используемая для команд (например, bash, zsh, powershell)• allowedDirectories : Массив путей файловой системы, к которым сервер может получить доступ для файловых операций (⚠️ команды терминала по-прежнему могут получать доступ к файлам за пределами этих каталогов)
Терминалexecute_commandВыполнение команды терминала с настраиваемым тайм-аутом и выбором оболочки
read_outputПрочитать новый вывод из запущенного сеанса терминала
force_terminateПринудительно завершить запущенный сеанс терминала
list_sessionsСписок всех активных терминальных сеансов
list_processesСписок всех запущенных процессов с подробной информацией
kill_processЗавершить запущенный процесс по PID
Файловая системаread_fileЧтение содержимого локальной файловой системы или URL-адресов (поддерживает текст и изображения)
read_multiple_filesЧтение нескольких файлов одновременно
write_fileПолностью заменить содержимое файла (лучше всего подходит для больших изменений)
create_directoryСоздайте новый каталог или убедитесь, что он существует
list_directoryПолучить подробный список файлов и каталогов
move_fileПеремещать или переименовывать файлы и каталоги
search_filesПоиск файлов по имени с использованием сопоставления подстрок без учета регистра
search_codeПоиск шаблонов текста/кода в содержимом файла с помощью ripgrep
get_file_infoПолучить подробные метаданные о файле или каталоге
Редактирование текстаedit_blockПрименить хирургическую замену текста (лучше всего подходит для изменений <20% размера файла)

Примеры использования инструмента

Формат блока поиска/замены:

filepath.ext <<<<<<< SEARCH content to find ======= new content >>>>>>> REPLACE

Пример:

src/main.js <<<<<<< SEARCH console.log("old message"); ======= console.log("new message"); >>>>>>> REPLACE

Поддержка URL-адресов

  • read_file теперь может извлекать содержимое как из локальных файлов, так и из URL-адресов
  • Пример: read_file с параметром isUrl: true для чтения из веб-ресурсов
  • Обрабатывает как текстовый, так и графический контент из удаленных источников.
  • Изображения (локальные или из URL-адресов) отображаются визуально в интерфейсе Клода, а не в виде текста.
  • Клод может видеть и анализировать фактическое содержание изображения
  • Тайм-аут по умолчанию для URL-запросов составляет 30 секунд.

Обработка длительных команд

Для команд, выполнение которых может занять некоторое время:

Управление конфигурацией

⚠️ Важные предупреждения о безопасности

  1. Всегда изменяйте конфигурацию в отдельном окне чата, в котором вы выполняете фактическую работу. Иногда Claude может попытаться изменить параметры конфигурации (например, allowedDirectories ), если он сталкивается с ограничениями доступа к файловой системе.
  2. Параметр allowedDirectories в настоящее время ограничивает только операции файловой системы , но не команды терминала. Команды терминала по-прежнему могут получать доступ к файлам за пределами разрешенных каталогов. Полная песочница терминала находится в планах.

Инструменты конфигурации

Управлять конфигурацией сервера можно с помощью предоставленных инструментов:

// Get the entire config get_config({}) // Set a specific config value set_config_value({ "key": "defaultShell", "value": "/bin/zsh" }) // Set multiple config values using separate calls set_config_value({ "key": "defaultShell", "value": "/bin/bash" }) set_config_value({ "key": "allowedDirectories", "value": ["/Users/username/projects"] })

Конфигурация сохраняется в config.json в рабочем каталоге сервера и сохраняется между перезапусками сервера.

Лучшие практики

  1. Создайте специальный чат для внесения изменений в конфигурацию : внесите все изменения в конфигурацию в одном чате, а затем начните новый чат для своей фактической работы.
  2. Будьте осторожны с пустыми allowedDirectories : установка этого параметра в пустой массив ( [] ) предоставляет доступ ко всей файловой системе для файловых операций.
  3. Используйте конкретные пути : вместо использования широких путей, таких как / , укажите точные каталоги, к которым вы хотите получить доступ.
  4. Всегда проверяйте конфигурацию после внесения изменений : используйте get_config({}) чтобы убедиться, что изменения были применены правильно.

Использование разных оболочек

Вы можете указать, какую оболочку использовать для выполнения команды:

// Using default shell (bash or system default) execute_command({ "command": "echo $SHELL" }) // Using zsh specifically execute_command({ "command": "echo $SHELL", "shell": "/bin/zsh" }) // Using bash specifically execute_command({ "command": "echo $SHELL", "shell": "/bin/bash" })

Это позволяет использовать специфические для оболочки функции или поддерживать единообразие сред между командами.

  1. execute_command возвращается после тайм-аута с начальным выводом
  2. Команда продолжается в фоновом режиме
  3. Используйте read_output с PID для получения нового вывода
  4. При необходимости используйте force_terminate для остановки.

Отладка

Если вам необходимо отладить сервер, вы можете установить его в режиме отладки:

# Using npx npx @wonderwhy-er/desktop-commander@latest setup --debug # Or if installed locally npm run setup:debug

Это позволит:

  1. Настройте Claude для использования отдельного сервера «desktop-commander»
  2. Включите протокол инспектора Node.js с помощью флага --inspect-brk=9229
  3. Приостановить выполнение в начале, пока не подключится отладчик
  4. Включить дополнительные переменные среды отладки

Чтобы подключить отладчик:

  • В Chrome перейдите на chrome://inspect и найдите экземпляр Node.js.
  • В VS Code используйте конфигурацию отладки «Присоединить к процессу узла»
  • Другие IDE/инструменты могут иметь похожие опции «присоединения» для отладки Node.js.

Важные замечания по отладке:

  • Сервер приостановится при запуске, пока не подключится отладчик (из-за флага --inspect-brk )
  • Если вы не видите активности во время отладки, убедитесь, что вы подключены к правильному процессу Node.js.
  • Возможно, запущено несколько процессов Node; подключитесь к тому, который находится на порту 9229.
  • В списке серверов MCP Клода отладочный сервер обозначен как «desktop-commander-debug».

Поиск неисправностей:

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

Интеграция протокола контекста модели

Этот проект расширяет возможности сервера файловой системы MCP, позволяя:

  • Поддержка локального сервера в Claude Desktop
  • Полное выполнение системных команд
  • Управление процессами
  • Операции с файлами
  • Редактирование кода с помощью блоков поиска/замены

Создано в рамках исследования Клода МКП: https://youtube.com/live/TlbjFDbl5Us

СДЕЛАННЫЙ

  • 29-04-2025 Отказ от телеметрии через конфигурацию - теперь в конфигурации есть настройка для отключения телеметрии, спросите в чате
  • 23-04-2025 Улучшенная функциональность редактирования - улучшенный формат, добавлен нечеткий поиск и многократные замены, должно быть меньше сбоев и чаще использоваться блок редактирования
  • 16-04-2025 Улучшенные конфигурации — улучшенные настройки разрешенных путей, команд и сред оболочки
  • 14-04-2025 Исправления среды Windows — Решены проблемы, характерные для платформ Windows
  • 14-04-2025 Улучшения Linux - Улучшенная совместимость с различными дистрибутивами Linux
  • 12-04-2025 Улучшенные разрешенные каталоги и заблокированные команды - Улучшенная безопасность и проверка пути для ограничений чтения/записи файлов и команд терминала. Терминал по-прежнему может получать доступ к файлам, игнорируя разрешенные каталоги.
  • 11-04-2025 Конфигурация оболочки - Добавлена возможность настройки предпочитаемой оболочки для выполнения команд.
  • 07-04-2025 Добавлена поддержка URL-адресов — команда read_file теперь может извлекать содержимое из URL-адресов
  • 28-03-2025 Исправлена ошибка JSON «Watching /» — реализован пользовательский транспорт stdio для обработки сообщений, отличных от JSON, и предотвращения сбоев сервера.
  • 25-03-2025 Улучшенный поиск кода ( объединен ) — улучшенное исследование кода с результатами, учитывающими контекст

Работа в процессе/TODO/дорожная карта

В настоящее время изучаются следующие возможности:

  • Поддержка WSL — подсистемы Windows для интеграции Linux
  • Поддержка SSH — удаленное выполнение команд сервера
  • Лучшая поддержка файлов в таких форматах, как CSV/PDF
  • Песочница терминала для Mac/Linux/Windows для лучшей безопасности
  • Режимы чтения файлов — например, разрешить чтение HTML как обычного текста или разметки.
  • Поддержка интерактивной оболочки - ssh, node/python repl
  • Улучшение чтения и записи больших файлов

❤️ Поддержка Desktop Commander

Зал славы болельщиков

Здесь представлены щедрые спонсоры. Спасибо за помощь в реализации этого проекта!

Веб-сайт

Посетите наш официальный сайт https://desktopcommander.app/ для получения последней информации, документации и обновлений.

СМИ

Узнайте больше об этом проекте с помощью следующих ресурсов:

Статья

Claude с MCPs заменил Cursor & Windsurf. Как это произошло? - Подробное исследование того, как Claude с возможностями Model Context Protocol меняет рабочие процессы разработчиков.

Видео

Видеоруководство по Claude Desktop Commander — посмотрите, как эффективно настроить и использовать Commander.

Публикация в AnalyticsIndiaMag

Этот разработчик отказался от Windsurf, Cursor, используя Claude с MCP

Сообщество

Присоединяйтесь к нашему серверу Discord , чтобы получать помощь, делиться отзывами и общаться с другими пользователями.

Отзывы

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgyyBt6\_ShdDX\_rIOad4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgztdHvDMqTb9jiqnf54AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgyQFTmYLJ4VBwIlmql4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=Ugy4-exy166\_Ma7TH-h4AaABAg

https://medium.com/@pharmx/you-sir-are-my-hero-62cff5836a3e

Если вы считаете этот проект полезным, пожалуйста, подумайте о том, чтобы поставить ему ⭐ звезду на GitHub! Это поможет другим узнать о проекте и поощрит его дальнейшее развитие.

Мы приветствуем вклад сообщества! Если вы нашли ошибку, у вас есть запрос на функцию или вы хотите внести свой код, вот как вы можете помочь:

  • Нашли ошибку? Откройте вопрос на github.com/wonderwhy-er/DesktopCommanderMCP/issues
  • Есть идея функции? Отправьте запрос функции в разделе вопросов
  • Хотите внести свой код? Сделайте форк репозитория, создайте ветку и отправьте запрос на извлечение
  • Вопросы или обсуждения? Начните обсуждение на вкладке GitHub Discussions

Мы будем очень признательны за любой вклад, большой или маленький!

Если вы считаете этот инструмент полезным для своего рабочего процесса, пожалуйста, рассмотрите возможность поддержки проекта .

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

Вот ответы на некоторые распространенные вопросы. Для более полного FAQ см. наш подробный документ FAQ .

Что такое Desktop Commander?

Это инструмент MCP, который позволяет Claude Desktop получать доступ к вашей файловой системе и терминалу, превращая Claude в универсального помощника для кодирования, автоматизации, исследования кодовой базы и многого другого.

Чем это отличается от Cursor/Windsurf?

В отличие от инструментов, ориентированных на IDE, Claude Desktop Commander обеспечивает ориентированный на решение подход, который работает со всей вашей ОС, а не только в среде кодирования. Claude считывает файлы целиком, а не разбивает их на части, может работать над несколькими проектами одновременно и вносит изменения за один раз, не требуя постоянного просмотра.

Нужно ли мне платить за API-кредиты?

Нет. Этот инструмент работает со стандартной подпиской Claude Desktop Pro (20 долл. США в месяц), а не с вызовами API, поэтому вам не придется нести дополнительных расходов сверх абонентской платы.

Обновляется ли Desktop Commander автоматически?

Да, при установке через npx или Smithery Desktop Commander автоматически обновляется до последней версии при перезапуске Claude. Ручной процесс обновления не требуется.

Каковы наиболее распространенные варианты использования?

  • Изучение и понимание сложных кодовых баз
  • Создание диаграмм и документации
  • Автоматизация задач в вашей системе
  • Работа с несколькими проектами одновременно
  • Внесение хирургических изменений в код с точным контролем

У меня возникли проблемы с установкой или использованием инструмента. Где я могу получить помощь?

Присоединяйтесь к нашему серверу Discord для поддержки сообщества, проверьте GitHub issues на предмет известных проблем или просмотрите полный FAQ для советов по устранению неполадок. Вы также можете посетить раздел FAQ на нашем сайте для более удобного использования. Если вы столкнулись с новой проблемой, пожалуйста, рассмотрите возможность открытия GitHub issue с подробностями о вашей проблеме.

Сбор данных и конфиденциальность

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

Телеметрия включена по умолчанию. Чтобы отказаться:

  1. Откройте чат и просто спросите: «Отключить телеметрию».
  2. Чат-бот автоматически обновит ваши настройки.

Подробную информацию о сборе данных можно найти в нашей Политике конфиденциальности .

Лицензия

Массачусетский технологический институт

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

Позволяет настольному приложению Claude выполнять команды терминала и редактировать файлы на вашем компьютере через MCP, с такими функциями, как выполнение команд, управление процессами и редактирование файлов на основе различий.

  1. Поиск, обновление, управление файлами и запуск команд терминала с помощью ИИ
    1. Оглавление
      1. Функции
        1. Установка
          1. Вариант 1: Установка через npx
          2. Вариант 2: использование установщика скрипта bash (macOS)
          3. Вариант 3: Установка через Smithery
          4. Вариант 4: Добавить в claude_desktop_config вручную
          5. Вариант 5: Оформить заказ на месте
          6. Обновление Desktop Commander
        2. Использование
          1. Доступные инструменты
          2. Примеры использования инструмента
          3. Поддержка URL-адресов
        3. Обработка длительных команд
          1. Управление конфигурацией
            1. ⚠️ Важные предупреждения о безопасности
            2. Инструменты конфигурации
            3. Лучшие практики
          2. Использование разных оболочек
            1. Отладка
              1. Интеграция протокола контекста модели
                1. СДЕЛАННЫЙ
                  1. Работа в процессе/TODO/дорожная карта
                    1. ❤️ Поддержка Desktop Commander
                      1. Зал славы болельщиков
                    2. Веб-сайт
                      1. СМИ
                        1. Статья
                        2. Видео
                        3. Публикация в AnalyticsIndiaMag
                        4. Сообщество
                      2. Отзывы
                        1. Часто задаваемые вопросы
                          1. Что такое Desktop Commander?
                          2. Чем это отличается от Cursor/Windsurf?
                          3. Нужно ли мне платить за API-кредиты?
                          4. Обновляется ли Desktop Commander автоматически?
                          5. Каковы наиболее распространенные варианты использования?
                          6. У меня возникли проблемы с установкой или использованием инструмента. Где я могу получить помощь?
                        2. Сбор данных и конфиденциальность
                          1. Лицензия

                            Related Resources

                            Related MCP Servers

                            • freecad mcp

                              neka-nat
                              A
                              security
                              A
                              license
                              A
                              quality
                              This repository is a FreeCAD MCP that allows you to control FreeCAD from Claude Desktop.
                              Last updated -
                              10
                              120
                              Python
                              MIT License
                              • Apple
                              • Linux

                            • Claude Desktop Commander MCP

                              StrawHatAI
                              -
                              security
                              A
                              license
                              -
                              quality
                              Allows Claude to execute terminal commands on your computer and perform file system operations including surgical code editing with diff-based replacements.
                              Last updated -
                              14,607
                              TypeScript
                              MIT License
                              • Apple
                              • Linux

                            • Terminal MCP Server

                              theailanguage
                              -
                              security
                              F
                              license
                              -
                              quality
                              An MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.
                              Last updated -
                              7
                              Python
                              • Apple

                            • Desktop Commander MCP

                              MrGNSS
                              -
                              security
                              A
                              license
                              -
                              quality
                              A server that lets Claude desktop app execute terminal commands on your computer and edit files through Model Context Protocol, featuring command execution, process management, and advanced file operations.
                              Last updated -
                              14,607
                              MIT License
                              • Linux
                              • Apple

                            View all related MCP servers

                            Appeared in Searches

                            ID: zempur9oh4