MCP Proxy Gateway

複数のMCPサーバーをラップし、ツール定義を圧縮してClaude Codeに公開するプロキシゲートウェイ。

特徴

• コンテキスト削減: ツール定義の圧縮で50-75%のトークン削減
• ツールフィルタリング: 必要なツールのみを公開
• 名前空間管理: ツール名衝突を回避するプレフィックス付与（upstream__toolname形式）
• 複数MCP対応: stdio型/HTTP型の両方をサポート

インストール

npm install
npm run build

使用方法

1. 設定ファイルの作成

mcp-proxy.config.yamlを作成:

upstreams:
  serena:
    type: stdio
    command: "uvx"
    args:
      - "--from"
      - "git+https://github.com/oraios/serena"
      - "serena"
      - "start-mcp-server"
    allowedTools:
      - find_symbol
      - get_symbols_overview

  deepwiki:
    type: http
    url: "https://mcp.deepwiki.com/mcp"
    allowedTools:
      - ask_question

2. Claude Codeとの統合

.mcp.jsonに追加:

{
  "mcpServers": {
    "proxy": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/path/to/mcp-proxy/dist/index.js",
        "--config",
        "/path/to/mcp-proxy/mcp-proxy.config.yaml"
      ]
    }
  }
}

3. 実行

# 開発モード
npm run dev -- --config mcp-proxy.config.yaml

# 本番モード
npm start -- --config mcp-proxy.config.yaml

設定オプション

upstreams

stdio型

upstreams:
  example:
    type: stdio
    command: "npx"
    args: ["-y", "some-mcp-server"]
    env:
      API_KEY: "${API_KEY}"
    allowedTools:
      - tool1
      - tool2

オプション	説明	必須
type	stdioを指定	◯
command	実行コマンド	◯
args	コマンド引数	-
env	環境変数	-
allowedTools	公開するツール（未指定時は全て）	-

HTTP型

upstreams:
  example:
    type: http
    url: "https://example.com/mcp"
    allowedTools:
      - tool1

オプション	説明	必須
type	httpを指定	◯
url	MCPエンドポイントURL	◯
allowedTools	公開するツール（未指定時は全て）	-

環境変数

設定ファイル内で${VAR}または${VAR:-default}形式で環境変数を参照可能:

upstreams:
  example:
    type: stdio
    command: "uvx"
    args: ["--project", "${PWD}"]
    env:
      API_KEY: "${API_KEY:-default_key}"

アーキテクチャ

Claude Code -----> MCP Proxy Gateway -----> Upstream MCPs
              stdio                    stdio/http
                    +-------------+
                    |ToolRegistry | フィルタリング・圧縮
                    +-------------+

ライセンス

MIT