Локальный MCP-сервер (stdio) с Docker

Этот проект представляет собой минимальный локальный MCP-сервер, который предоставляет инструмент run_command через stdio.

Настройка

cd ~path-to-directory/local-mcp-with-docker
uv sync

Запустите скрипт с помощью:

uv run main.py

Примечание: начиная с MCP 2.0, после запуска сервера в консоли не будет вывода. Процесс остаётся активным и ожидает сообщений stdio от MCP-клиента. Вы можете проверить его с помощью отладчика в новом сеансе терминала.

Запустите инспектор:

npx -y @modelcontextprotocol/inspector

Затем в интерфейсе инспектора:

• Транспорт: stdio

• Команда: uv

• Аргументы: run, python, main.py

• Рабочая директория: ~path-to-directory/local-mcp-with-docker

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

Related MCP server: mcp-stdio

Сборка Docker-образа

docker build -t terminal_tool_docker .

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

Конфигурация Claude Desktop

Добавьте это в файл конфигурации MCP вашего Claude Desktop:

{
  "mcpServers": {
    "local-mcp-with-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "-e",
        "WORKSPACE_DIR=/root/mcp/workspace",
        "-v",
        "path-to-directory/local-mcp-with-docker:/root/mcp/workspace",
        "terminal_tool_docker"
      ]
    }
  }
}

Это монтирует вашу рабочую область в контейнер и указывает серверу правильную рабочую директорию внутри контейнера.

Скриншот Claude