Dockerを使用したローカル(stdio) MCPサーバー

このプロジェクトは、stdio上でrun_commandツールを公開する最小限のローカルMCPサーバーです。

セットアップ

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

以下のコマンドでスクリプトを起動します:

uv run main.py

注意: MCP 2.0以降、サーバー起動後はコンソールに出力はありません。プロセスは生き続け、MCPクライアントからのstdioメッセージを待ちます。新しいターミナルセッションでデバッガを使用して確認できます。

インスペクターを起動:

npx -y @modelcontextprotocol/inspector

次にインスペクターUIで:

• トランスポート: 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 .

これにより、Claude Desktop MCP設定で使用されるローカルDockerイメージが作成されます。

Claude Desktopの設定

これをClaude DesktopのMCP設定ファイルに追加します:

{
  "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のスクリーンショット