Skip to main content
Glama
deenesjakoruzh
RaiAnsar

MCP Gateway

by RaiAnsar
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

MCP Gateway

ClaudeとMCPサーバーの間に配置する遅延読み込みプロキシです。起動時にすべてのサーバーを読み込む（何百ものツールスキーマをコンテキストにダンプし、トークンを浪費する）代わりに、ゲートウェイは4つの軽量なツールのみを公開します。バックエンドサーバーは、実際に必要になったときにのみ起動します。

以前: 10個のMCPサーバー = すべての会話に200以上のツールスキーマが読み込まれ、数千トークンが無駄になる。

以後: ゲートウェイ配下に10個のMCPサーバー = 4つのツールスキーマのみが読み込まれる。各サーバーはオンデマンドで起動する。

問題点

Claude Codeに追加するすべてのMCPサーバーは、そのすべてのツールを事前に登録します。一般的なサーバーには10〜30個のツールがあり、それぞれに完全なJSONスキーマが含まれています。10個のサーバーがあれば、質問をする前に100〜300個のツール定義がコンテキストウィンドウを消費してしまいます。

ほとんどの会話では1〜2個のサーバーしか使用されません。残りは不要な重荷となります。

仕組み

ゲートウェイはClaudeに対して4つのツールを公開します。

ツール

機能

gateway_list_servers

利用可能なサーバーとそのステータスを表示する

gateway_load_server

サーバーに接続し、そのツールを検出する

gateway_call_tool

接続されたサーバー上のツールを呼び出す

gateway_reload_server

サーバーを再接続する（コードの変更を反映する）

Claudeがサーバーを必要とすると、gateway_load_serverを呼び出します。ゲートウェイはサブプロセスを開始し、MCPハンドシェイクを行い、接続をキャッシュします。その後の呼び出しでは、実行中のプロセスが再利用されます。

使用されないサーバーは起動しません。トークンは無駄になりません。

クイックスタート

git clone https://github.com/raiansar/mcp-gateway.git
cd mcp-gateway
./install.sh

config.jsonを編集してサーバーを追加し、Claude Codeにゲートウェイを追加します。

claude mcp add gateway -- /path/to/mcp-gateway/run.sh

以上です。すべてのサーバーが単一のゲートウェイの背後に配置されました。

設定

config.jsonは、サーバー名と接続詳細をマッピングしたシンプルなファイルです。ゲートウェイはstdio（ローカルプロセス）とHTTP（リモートサーバー）の両方のトランスポートをサポートしています。

Stdioサーバー (ローカル)

{
  "servers": {
    "my-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "some-mcp-server@latest"],
      "env": {
        "API_KEY": "your-key"
      },
      "timeout": 30,
      "description": "What this server does"
    }
  }
}

HTTPサーバー (リモート)

{
  "servers": {
    "remote-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      },
      "timeout": 60,
      "description": "Remote MCP server"
    }
  }
}

Pythonサーバー (uv)

{
  "servers": {
    "my-python-server": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/server", "server-name"],
      "env": {},
      "timeout": 120,
      "description": "Python server managed by uv"
    }
  }
}

設定フィールド

フィールド

必須

デフォルト

説明

type

いいえ

stdio

トランスポート: stdio, http, sse, または streamable-http

command

はい (stdio)

-

サーバーを実行するコマンド

args

いいえ

[]

コマンド引数

env

いいえ

{}

環境変数

url

はい (http)

-

サーバーURL

headers

いいえ

{}

HTTPヘッダー (認証トークンなど)

timeout

いいえ

30/60

リクエストタイムアウト（秒単位、stdioは30、httpは60）

description

いいえ

-

gateway_list_serversで表示される人間が読める説明

既存のMCPサーバーの移行

すでにClaude CodeにMCPサーバーを設定している場合は、それらをゲートウェイに移行してください。

以前 (~/.claude.json または Claude Desktop設定内):

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": { "TAVILY_API_KEY": "tvly-xxx" }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
      "env": {}
    }
  }
}

以後 (config.json内):

{
  "servers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" },
      "description": "GitHub - repos, issues, PRs, code search"
    },
    "tavily": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": { "TAVILY_API_KEY": "tvly-xxx" },
      "description": "Tavily AI search"
    },
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
      "env": {},
      "description": "File system access"
    }
  }
}

その後、個別のサーバーをClaudeから削除し、ゲートウェイのみを追加します。

claude mcp remove github -s user
claude mcp remove tavily -s user
claude mcp remove filesystem -s user
claude mcp add gateway -- /path/to/mcp-gateway/run.sh

使用方法

設定が完了すると、Claudeは自動的にゲートウェイを使用します。一般的なやり取りは以下の通りです。

  1. Claudeが gateway_list_servers を呼び出し、利用可能なサーバーを確認する

  2. ClaudeがGitHubを必要とするときに gateway_load_server("github") を呼び出す

  3. Claudeが gateway_call_tool("github", "search_repositories", '{"query": "mcp"}') を呼び出してツールを使用する

  4. GitHubサーバーは同じセッション内の後続の呼び出しのために実行され続ける

設定内の description フィールドは、Claudeが特定のタスクに対してどのサーバーを読み込むべきかを判断するのに役立つため、適切な説明を記述してください。

RTKとの違い

RTKは、シェルコマンドの出力（git、ls、テストランナーなど）を圧縮してトークン消費を60〜90%削減するCLIプロキシです。

MCP Gatewayは異なる問題を解決します。すべてのツールを事前に登録するのではなく、必要に応じてサーバーを遅延読み込みすることで、MCPツールスキーマの肥大化を防ぎます。

MCP Gateway

RTK

問題

アイドル状態のMCPサーバーからのツールスキーマがコンテキストを浪費する

冗長なCLI出力がコンテキストを浪費する

方法

サーバーを遅延読み込みし、4つのプロキシツールを公開する

コンテキストに到達する前にコマンド出力を圧縮する

タイミング

起動時 / ツール登録時

実行時 / コマンド実行時

範囲

MCPサーバー管理

シェルコマンド (git, npm, cargoなど)

これらは補完的な関係にあります。最大限のトークン節約のために両方を使用してください。

要件

  • Python 3.10+

  • mcp パッケージ (install.sh でインストール)

ライセンス

MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RaiAnsar/mcp-gateway'

If you have feedback or need assistance with the MCP directory API, please join our Discord server