Claude Mcp Server Gateway

Claude MCP サーバーゲートウェイ

Claude Desktop、Claude Code、Cline、Roo 向けの Python 製 MCP サーバーゲートウェイです。起動時にすべての MCP ツールを読み込むのではなく、必要に応じて読み込みます。

対応環境： Claude Desktop（アプリ）、Claude Code（ターミナル）、Cline と Roo（VSCode 拡張機能）

互換性

プラットフォーム	設定ファイル	対応
Claude Desktop	claude_desktop_config.json	はい
Claude Code	.claude.json or .mcp.json	はい
Cline (VSCode)	cline_mcp_settings.json	はい

MCP サーバーの問題

複数の MCP サーバーを Claude に接続すると、次のようになります。

• GitHub MCP サーバー：51 個のツール
• Slack MCP サーバー：20 個のツール
• Google Drive MCP：15 個のツール
• Filesystem MCP：12 個のツール

使い始める前に、100 個以上の MCP ツール定義が読み込まれてしまいます。各ツールの JSON スキーマがトークンを消費します。

この Claude MCP サーバーゲートウェイの機能

このゲートウェイは、3 つのツールを備えた単一の MCP サーバーとして動作します。

1. list_available_mcps - 設定済みの MCP サーバーを表示します
2. load_mcp_tools - 特定の MCP サーバーからツールを読み込みます
3. call_mcp_tool - ツールを実行します

Claude が実際に必要とするまで、Model Context Protocol サーバーは起動しません。

セットアップ

必要条件

• Python 3.11+（MCP Python SDK 用）
• Claude Desktop、Claude Code、または Cline/Roo
• 使用する MCP サーバー

インストール

git clone https://github.com/bzsasson/claude-mcp-server-gateway.git
cd claude-mcp-server-gateway

python3.11 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

pip install mcp python-dotenv

API キーの設定

cp .env.example .env
# Edit .env with your tokens

Claude Desktop の MCP サーバー設定

Claude Desktop の設定に追加します。

Mac：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gateway": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"]
    }
  }
}

Claude Desktop を再起動します。

Claude Code への MCP サーバーの追加方法

Claude Code の MCP サーバー設定では、似た形式の設定を使用しますが、追加のフィールドが 1 つあります。

ユーザーレベルの設定（すべてのプロジェクト）

~/.claude.json を編集します。

{
  "mcpServers": {
    "gateway": {
      "type": "stdio",
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"]
    }
  }
}

プロジェクトレベルの設定

プロジェクト固有の MCP サーバーを設定するには、プロジェクトのルートに .mcp.json を作成します。

{
  "mcpServers": {
    "gateway": {
      "type": "stdio",
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"]
    }
  }
}

プロジェクトスコープのサーバーを使用する際、Claude Code は承認を求めます。

代替方法：Claude Code CLI

# Add the gateway using CLI
claude mcp add gateway --scope user \
  --command /path/to/.venv/bin/python \
  -- /path/to/claude-mcp-server-gateway/dcl_wrapper.py

# Verify it's added
claude mcp list

Cline/Roo の MCP サーバー設定

Cline と Roo（VSCode 拡張機能）では、MCP サーバーゲートウェイの設定を次の場所に追加します。

Mac：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows：%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Linux：~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "gateway": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/claude-mcp-server-gateway/dcl_wrapper.py"],
      "disabled": false
    }
  }
}

設定を更新したら、VSCode を再起動します。

動作の仕組み

1. Claude が起動し、ゲートウェイ（3 つのツール）が表示されます
2. GitHub について質問すると、Claude は list_available_mcps を呼び出します
3. Claude は GitHub が利用可能だと確認し、load_mcp_tools("github") を呼び出します
4. ゲートウェイが GitHub のツール一覧を返します
5. Claude が適切なツールを選び、call_mcp_tool("github", "search_repositories", {...}) を呼び出します
6. ゲートウェイが GitHub MCP を起動してツールを実行し、結果を返します

ゲートウェイへの MCP サーバーの追加

dcl_wrapper.py を編集し、MCP_SERVERS 辞書に追加します。

MCP_SERVERS = {
    "your-server": {
        "command": "npx",
        "args": ["-y", "your-mcp-package"],
        "env": {
            "API_KEY": os.getenv("YOUR_API_KEY", "")
        },
        "description": "What it does"
    }
}

現在設定されているサーバー

• github
• slack
• google-drive
• filesystem
• postgres
• memory
• brave-search

（全リストは dcl_wrapper.py を確認してください）

制限事項

• 初回のツール使用時にわずかな遅延があります（サーバーの起動）
• 各 MCP サーバーとの接続は一時的です
• 呼び出し間で状態は保持されません

トラブルシューティング

ゲートウェイが表示されない

• 設定内の Python パスが仮想環境を指していることを確認します
• dcl_wrapper.py のパスが正しいことを確認します
• Claude Desktop/Code/VSCode を完全に再起動します

MCP サーバー接続エラー

• .env ファイル内の API キーを確認します
• MCP サーバーのパッケージがインストールされていることを確認します
• ゲートウェイのログでエラーを確認します

Claude Code 固有の問題

• 設定に "type": "stdio" を含めてください
• プロジェクト設定の場合、プロンプトが表示されたら承認してください
• claude mcp list を使用して、インストールを確認します

Files

• dcl_wrapper.py - The gateway server
• .env - Your API keys
• requirements.txt - Python dependencies

License

MIT