MCP Gateway

MCP Gateway

複数の MCP リソースサーバーを単一のインターフェース経由で集約する MCP ゲートウェイです。

機能

• MCP Proxy：複数の MCP サーバーにアクセスするための単一のエンドポイント
• バッチリクエストツール：複数のツール呼び出しを最適化して並列実行
• 設定のマージ：Claude デスクトップ設定に対応

設定ファイルのパス

ゲートウェイは、次の順序で設定ファイルを探します。

1. 環境変数： 設定されている場合は MCP_CONFIG_PATH
2. Claude デスクトップ設定：
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json
3. デフォルト： 現在のディレクトリにある config.json

Claude との設定のマージ

ゲートウェイは、Claude デスクトップ設定から proxyBatchMcpServers セクションを読み込めます。

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "@thinkware/mcp-gateway"
      ]
    }
  },
  "proxyBatchMcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ],
      "toolOverrides": {
        "read_file": {
          "enabled": true,
          "description": "Read complete contents of a file\nInput: path (string)\nReads complete file contents with UTF-8 encoding"
        },
        "read_multiple_files": {
          "enabled": false
        }
      }
    },
    "server-1": {
      "command": "/path/to/server1/build/index.js",
      "toolOverrides": {
        "some_tool": {
          "enabled": true,
          "description": "Custom description"
        }
      }
    }
  }
}

サーバー設定オプション

オプション	型	説明	必須
command	string	サーバー実行ファイルのパス	はい（コマンドサーバーの場合）
args	string[]	コマンドの引数	いいえ
env	object	環境変数	いいえ
url	string	SSE エンドポイント URL	はい（SSE サーバーの場合）
toolOverrides	object	ツールのカスタマイズ	いいえ

ツールのオーバーライドオプション

オプション	型	説明	デフォルト
enabled	boolean	ツールを有効／無効にする	true
description	string	ツールのカスタム説明	元の説明
disabled	boolean	ツール全体を無効にする	false

環境変数

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "npx",
      "args": [
        "-y",
        "@thinkware/mcp-gateway"
      ],
      "env": {
        "MCP_GATEWAY_LOG_FILE": "/path/to/logs/mcp-gateway.log"
      }
    }
  }
}

開発

# Install dependencies
npm install

# Development with auto-rebuild
npm run dev

# Build
npm run build