Universal MCP Gateway

Ein lokaler MCP-Einstiegspunkt für mehrere Code-Agenten. Er leitet konfigurierte Upstream-MCP-Tools als Proxy weiter, hält Upstream-Sessions warm, seriisisiert Aufrufe für Exklusiv-Dienste, meldet Prozess-Ressourcen und bereitgestellt kleine SQLite-gestützte Tools für Aufgaben, Sperren und Speicher.

Schnellstart

python -m pip install -e '.[dev]'
cp config.example.toml config.toml
mcp-gateway serve --config config.toml

Verbinden Sie einen MCP-Cilent mit:

http://127.0.0.1:8000/mcp

Clients, die nur stdio, die nur stdio unterstützen, können einen einzelnen Gateway-Bridge-Prozess ausführen:

{
  "command": "mcp-gateway",
  "args": ["serve", "--config", "/absolute/path/config.toml", "--transport", "stdio"]
}

Related MCP server: warmplane

Konfiguration

[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

Upstream-Tools sind als <server_id>__<tool_name> verfigbar. Gateway-Koordinationsools verwenden das Präfix gateway__. per_agent ist in v0.1 auf den Prozess begrenzt; führen Sie einen stdio-Gateway-Bridge pro Agent aus, wenn getrennte Upstream-Sessions erforderlich sind. Die erste Version setzt nur Tools als Proxy; Ressourcen, Prompts, Sampling und verteilte Ablaufplanung sind von Sie bewusst zurückgestellt.

Betrieb

mcp-gateway status
mcp-gateway start example
mcp-gateway stop example
mcp-gateway restart example

Die Adin-API ist standardmäßig nur über Loopback erreichar:

GET  /health
GET  /v1/status
POST /v1/servers/{id}/start
POST /v1/servers/{id}/stop
POST /v1/servers/{id}/restart

Setzen Sie die konfigurierte Tokken-Umgebung variable, um Authorization: Bearer ... für MामCP- und Adin-HTTP-Anfragen zu verlangen. MCP-Argumente und -Kommando werden nur aus TOML lesen; der Gateway führt niemals einen Shell-Befehls-Sring aus, den ein Agent empfängt.

Freie Arbeits-Tools

Der Gateway bereit über gateway__*-ools Task-Leasing, optimistische Task-Aktualisierungen, Datei-Sperre sowie pojektspezifischen Speicher bereit. SQLite verwendet den WAL-Modus und kur die Transaktionen. Sperren und Leases laufen ab, sodass ein getrenntes Agent nicht dauerhaft Ressourcen belegt.

Speichern Sie keine Zugangsdaten, rohen Transkripttions- oder Unzahlungsdaten in der lokalen Speicherdatenbank.

Enticklung

python -m pytest -q
python -m compileall -q universal_mcp_gateway
git diff --check

Siehe SPEC.md und tasks/plan.md für den aktuellen Vertrag und aufgeschobene Aufgaben.