MCP Simple Gateway

MCP Simple Gateway

MCP Simple Gateway は、単一のインターフェースを通じて複数の MCP サーバーを集約および管理できる、Model Context Protocol（MCP）用のプロキシサーバーです。

主な機能

• 🚀 複数の MCP サーバーを集約
• 🔒 トークンベースの認証をサポート
• 📝 柔軟な JSON ベースの設定
• 🐳 Docker をサポート
• 🔌 SSE、stdio、StreamableHTTP の MCP をサポート

使い方

CLI で実行

npx mcp-simple-gateway --config config.json

Docker Compose で実行

docker-compose.yml の例：

services:
  mcp-gateway:
    platform: linux/amd64 # For Apple Silicon Users
    image: ghcr.io/denwakeup/mcp-simple-gateway:latest
    volumes:
      - ./config.json:/app/config.json
    ports:
      - '3000:3000'
    environment:
      - CONFIG_PATH=/app/config.json

設定

設定ファイル（config.json）の例：

{
  "proxyServer": {
    "logLevel": "debug",
    "logPretty": true,
    "authTokens": ["your-auth-token"],
    "cors": {
      "origin": true
    }
  },
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=Europe/Moscow"],
      "proxyOptions": {
        "authTokens": ["server-specific-token"]
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/app/files"]
    },
    "echo": {
      "type": "streamableHttp",
      "url": "http://localhost:8080/mcp"
    }
  }
}

設定パラメーター

• proxyServer.options：

  • logLevel：ログレベル（debug、info、warn、error）
  • logPretty：ログの形式
  • authTokens：認証トークンの配列（すべてのサーバーのデフォルトとして使用）
  • cors：CORS の設定オプション（任意）

• mcpServers：MCP サーバーの設定

  • [serverName]：
    • command：サーバーを起動するコマンド（stdio サーバー用）
    • args：コマンド引数（stdio サーバー用）
    • url：サーバーの URL（SSE および StreamableHTTP サーバー用）
    • type：サーバーの種類（stdio および SSE では任意、StreamableHTTP では必須）
    • proxyOptions：特定のサーバー用のプロキシオプション
      • authTokens：認証トークンの配列（特定のサーバーについては、proxyServer.options.authTokens を上書きします）

上記の設定に基づくと、MCP サーバーにアクセスする URL は次のとおりです。

http://localhost:3000/time/sse
http://localhost:3000/filesystem/sse
http://localhost:3000/echo/sse

• localhost:3000 - プロキシサーバーのアドレスとポート（デフォルト）
• /time/sse、/filesystem/sse、/echo/sse - mcpServers 設定のキーに対応する MCP サーバーのパス

ロードマップ

• CORS のサポート
• Streamable HTTP のサポート

ライセンス

MIT