shellserver

Небольшой сервер Model Context Protocol (MCP), созданный с помощью Python MCP SDK (FastMCP). Он предоставляет один инструмент, который запускает команды оболочки на машине, где выполняется процесс сервера.

Требования

• Python 3.14+ (см. pyproject.toml)

• uv для установки и запуска зависимостей

Related MCP server: Shell MCP Server

Настройка

Клонируйте или скопируйте этот репозиторий, затем из корня проекта:

uv sync

Запуск сервера

Сервер использует транспорт stdio (по умолчанию для FastMCP).

uv run python server.py

Не передавайте дополнительные данные в stdout из процесса сервера; MCP использует stdout для JSON-RPC. Логирование в server.py направляется в stderr.

Инструмент: terminal_tool

Инструмент возвращает один текстовый блок, содержащий exit_code, stdout и stderr. Если команда превышает время ожидания, процесс завершается, и ответ указывает на тайм-аут.

Подключение клиента (пример локального запуска)

Укажите вашему MCP-хосту uv, используя этот проект в качестве рабочей директории. Пример конфигурации:

{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absolute/path/to/shellserver"
    }
  }
}

Настройте имя ключа и cwd в соответствии с вашим редактором или клиентом.

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

Этот сервер выполняет произвольные команды оболочки на хосте. Любой, кто может вызывать инструменты MCP на этом сервере, фактически получает доступ к оболочке этой машины. Используйте только на доверенных хостах, с доверенными клиентами и с четким пониманием рисков.