Universal MCP Gateway
Universal MCP Gateway
複数のコーディングエージェントのための、単一のローカル MCP エントリポイントです。設定済みのアップストーム MCP ツールをプロキシし、アップストームセッションをウォーム状態に保ち、排他サービス向けの呼び出しを列化し、プロセスリソースをレポートし、SQLite をバックエンドとする小規模のタスク・ロック・メモリツールを提供します。
クイックスタート
python -m pip install -e '.[dev]'
cp config.example.toml config.toml
mcp-gateway serve --config config.tomlMCP クライアントを接続します:
http://127.0.0.1:8000/mcpstdio のみをサポートするクライアントは、ゲートウェイブリッジプロセスを 1 つ実行できます:
{
"command": "mcp-gateway",
"args": ["serve", "--config", "/absolute/path/config.toml", "--transport", "stdio"]
}Related MCP server: warmplane
設定
[gateway]
host = "127.0.0.1"
port = 8000
database = "gateway.db"
auth_token_env = "MCP_GATEWAY_TOKEN"
[servers.example]
transport = "stdio"
command = "npx"
args = ["-y", "some-mcp-server"]
mode = "exclusive"
max_in_flight = 1
queue_limit = 32
[servers.remote]
transport = "streamable_http"
url = "http://127.0.0.1:9000/mcp"
mode = "pool"
max_connections = 2
queue_limit = 64アップストームのツールは、<server_id>__<tool_name> として公開されます。ゲートウェイの提調整ツールは gateway__ プレフィックスを使います。per_agent は v0.1 ではプロセススコープです。個別のアップストームセッションが必な場合は、エージェントごとに stdio ゲートウェイブリッジを 1 つ実行してください。最初のリースでプロキシされるのはツールのみです。リソース、プロンプト、サンプリング、分散スケジュリングは意図的に後回しにされています。
運用
mcp-gateway status
mcp-gateway start example
mcp-gateway stop example
mcp-gateway restart example管理 API はデフォルトでループバック専用です:
GET /health
GET /v1/status
POST /v1/servers/{id}/start
POST /v1/servers/{id}/stop
POST /v1/servers/{id}/restart設定したトークン環境変数をを設定すると、MCP および管理 HTTP リクエストに Authorization: Bearer ... が要されます。コマンド引数は TOML からのみ読取ります。ゲートウェイがエージジェントから受け取っシェル文字列を実行することはありません。
共有作業ツール
ゲートウェイは gateway__* ツールを通じて、タスクリース、オプティミスティックなタスク更新、リソースロック、プロジェクト・スコープのテキストメモリを提供します。SQLite は WM モードを使し、トランザクションは短時間で完結します。タスクリースとリソースロックは有効期限があるため、切断されたエージジェントが作業を無期に保持することはありません。
開発
python -m pytest -q
python -m compileall -q universal_mcp_gateway
git diff --check現時点の契約と残タスクについては、SPEC.md と tasks/plan.md を参照してください。
This server cannot be deployed
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Hosted MCP server for task-first delegation to remote workstations and workers.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseBqualityAmaintenanceAn agent-neutral MCP server providing SQLite key/value storage, Postgres knowledge base, and Kart task queue functionality. Features SAP/1.0 authorization on every tool call for secure multi-application access.1,543 PyPI3Apache 2.0
- FlicenseNot gradedqualityAmaintenanceRuns multiple upstream MCP servers behind one local process, keeping sessions persistent and exposing a compact, policy-aware surface for tools, resources, and prompts via HTTP, CLI, and MCP-native clients.4-
- AlicenseNot gradedqualityBmaintenanceProvides a centralized, deterministic MCP endpoint with routing, logging, and browser automation, enabling multiple LLMs to share a consistent set of tools including jq, ripgrep, Git, Python, and headless Chromium.MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to manage SQLite-backed TODOs and schedule durable coding-agent jobs over stdio, with persistent job memory, run history, and a read-only dashboard.MIT