mcp-server-commands

Инструмент runProcess

Инструмент runProcess запускает процессы на хост-машине. Существует два взаимоисключающих способа его вызова:

1. command_line (строка) — выполняется через системную оболочку по умолчанию (как при вводе в bash/fish/pwsh и т. д.). Работают все функции оболочки, такие как конвейеры (pipes), перенаправления и раскрытие переменных.

2. argv (массив строк) — прямой вызов исполняемого файла. argv[0] — это исполняемый файл, остальные элементы — аргументы. Интерпретация оболочкой не производится.

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

Если вы хотите, чтобы ваша модель использовала определенные оболочки в системе, я бы рекомендовал перечислить их в системном промпте. Или, возможно, в инструкциях к инструменту, хотя модели, как правило, лучше обращают внимание на примеры в системном промпте.

Дайте знать, если столкнетесь с проблемами!

Related MCP server: buildkite-mcp-server

Инструменты

Инструменты предназначены для запросов LLM. Claude Sonnet 3.5 интеллектуально использует run_process. Первоначальное тестирование также показывает многообещающие результаты с Groq Desktop с MCP и моделями llama4.

В настоящее время есть только одна команда на все случаи жизни!

• run_process — запуск команды, например hostname, ls -al или echo "hello world" и т. д.

  • Возвращает STDOUT и STDERR в виде текста

  • Необязательный параметр stdin означает, что ваша LLM может:

    • передавать скрипты через STDIN таким командам, как fish, bash, zsh, python

    • создавать файлы с помощью cat >> foo/bar.txt из текста в stdin

[!WARNING] Будьте осторожны с тем, какие команды вы просите этот сервер выполнять! В приложении Claude Desktop используйте Approve Once (а не Allow for This Chat), чтобы вы могли проверять каждую команду, и используйте Deny, если не доверяете команде. Права доступа определяются пользователем, который запускает сервер. НЕ запускайте с sudo.

Видеоинструкция

Промпты

Промпты предназначены для включения пользователями в историю чата, например, через слэш-команды Zed (в панели AI Chat).

• run_process — генерация сообщения с выводом команды

• К сведению, это было в основном учебное упражнение... Я рассматриваю это как вызов инструмента по запросу пользователя. Это модный способ сказать, что это шаблон для запуска команды и передачи результатов модели!

Разработка

Установка зависимостей:

npm install

Сборка сервера:

npm run build

Для разработки с автоматической пересборкой:

npm run watch

Установка

Для использования с Claude Desktop добавьте конфигурацию сервера:

На MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json На Windows: %APPDATA%/Claude/claude_desktop_config.json

Groq Desktop (бета, macOS) использует ~/Library/Application Support/groq-desktop-app/settings.json

Использование опубликованного npm-пакета

Опубликовано в npm как mcp-server-commands с использованием этого рабочего процесса

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": ["mcp-server-commands"]
    }
  }
}

Использование локальной сборки (клонирование репозитория)

Убедитесь, что выполнили npm run build

{
  "mcpServers": {
    "mcp-server-commands": {
      // works b/c of shebang in index.js
      "command": "/path/to/mcp-server-commands/build/index.js"
    }
  }
}

Локальные модели

• Большинство моделей обучены так, что они не считают, что могут выполнять команды за вас.

  • Иногда они используют инструменты без колебаний... в других случаях мне приходится их уговаривать.

  • Используйте системный промпт или шаблон промпта, чтобы дать указание следовать запросам пользователя. Включая использование run_process без дополнительной проверки.

• Ollama — отличный способ запускать модель локально (с Open-WebUI)

# NOTE: make sure to review variants and sizes, so the model fits in your VRAM to perform well!

# Probably the best so far is [OpenHands LM](https://www.all-hands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model)
ollama pull https://huggingface.co/lmstudio-community/openhands-lm-32b-v0.1-GGUF

# https://ollama.com/library/devstral
ollama pull devstral

# Qwen2.5-Coder has tool use but you have to coax it
ollama pull qwen2.5-coder

HTTP / OpenAPI

Сервер реализован с использованием транспорта STDIO. Для HTTP используйте mcpo для интерфейса веб-сервера, совместимого с OpenAPI. Это работает с Open-WebUI

uvx mcpo --port 3010 --api-key "supersecret" -- npx mcp-server-commands

# uvx runs mcpo => mcpo run npx => npx runs mcp-server-commands
# then, mcpo bridges STDIO <=> HTTP

[!WARNING] Я кратко использовал mcpo с open-webui, обязательно проверьте его на предмет проблем с безопасностью.

Логирование

Приложение Claude Desktop записывает логи в ~/Library/Logs/Claude/mcp-server-mcp-server-commands.log

По умолчанию логируются только важные сообщения (например, ошибки). Если вы хотите видеть больше сообщений, добавьте --verbose в args при настройке сервера.

Кстати, логи записываются в STDERR, потому что именно туда Claude Desktop направляет файлы логов. В будущем я ожидаю, что хорошо отформатированные сообщения логов будут записываться через транспорт STDIO в MCP-клиент (примечание: не в приложение Claude Desktop).

Отладка

Поскольку MCP-серверы обмениваются данными через stdio, отладка может быть сложной. Мы рекомендуем использовать MCP Inspector, который доступен как скрипт пакета:

npm run inspector

Inspector предоставит URL для доступа к инструментам отладки в вашем браузере.