Skip to main content
Glama
deenesjakoruzh
deuriib

mcp-gway

by deuriib
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

MCP Gateway

PyPI version Python License

Una puerta de enlace CLI independiente que agrega múltiples servidores MCP (Model Context Protocol) detrás de un único endpoint HTTP/SSE con Code Mode — reduciendo el uso de tokens de entrada del LLM hasta en un 92% al usar múltiples servidores MCP.

Características

  • Agregación de múltiples servidores — Conéctese a múltiples servidores MCP (HTTP, SSE, Stdio, Streamable HTTP) y expóngalos a través de un único endpoint

  • Code Mode — 4 meta-herramientas que permiten a los LLM descubrir y usar herramientas dinámicamente sin cargar todos los esquemas de antemano

  • Soporte OAuth 2.0 — Flujo OAuth integrado con registro dinámico de clientes (RFC 7591) y almacenamiento de tokens

  • Sandbox hermético — Sandbox basado en Starlark para la ejecución segura de código

  • Compatible con el protocolo MCP — Funciona con Claude Desktop, Cursor y cualquier cliente compatible con MCP

Related MCP server: ToolMux

Instalación

pip install mcp-gway

O con mise:

mise install
uv sync

Inicio rápido

# Add an MCP server
mcp-gway add youtube --type http --url http://localhost:3001/mcp

# Add a stdio server
mcp-gway add filesystem --type stdio --command npx --args '["-y", "@anthropic/mcp-filesystem"]'

# Add a server requiring OAuth
mcp-gway add supabase --type streamable-http --url https://mcp.supabase.com/mcp

# List all servers
mcp-gway list

# Start the gateway
mcp-gway serve --port 8080

Conectar desde Claude Desktop

Agregue a su configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gateway": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Comandos

Comando

Descripción

mcp-gway add

Agregar un servidor MCP y generar stub .pyi

mcp-gway remove

Eliminar un servidor MCP

mcp-gway update

Actualizar herramientas para un servidor

mcp-gway list

Listar todos los servidores conectados

mcp-gway inspect

Mostrar firmas de herramientas para un servidor

mcp-gway refresh

Refrescar la conexión y redescubrir herramientas

mcp-gway serve

Iniciar el servidor de puerta de enlace

Code Mode

Cuando está conectado, la puerta de enlace expone 4 meta-herramientas:

Herramienta

Descripción

listToolFiles

Listar todos los archivos stub .pyi disponibles

readToolFile

Leer firmas de funciones de un stub

getToolDocs

Obtener documentación detallada de una herramienta

executeToolCode

Ejecutar código en un intérprete Starlark en sandbox

Autenticación OAuth

Para servidores que requieren OAuth (por ejemplo, Supabase):

# Trigger OAuth flow
mcp-gway refresh supabase --auth

# Or store token manually
mkdir -p ~/.config/mcp-gway/tokens
echo '{"access_token": "YOUR_TOKEN"}' > ~/.config/mcp-gway/tokens/supabase.json

Desarrollo

# Install dependencies
mise install
uv sync

# Run tests
uv run pytest -v

# Lint and format
uv run ruff check src/ tests/
uv run ruff format src/ tests/

Arquitectura

┌─────────────────────────────────────────────────────────┐
│                    MCP Gateway                          │
├─────────────────────────────────────────────────────────┤
│  CLI (click)     │  HTTP/SSE Server (Starlette)        │
│  - add           │  - POST /mcp (JSON-RPC)             │
│  - remove        │  - GET /mcp (SSE stream)            │
│  - list          │  - POST /mcp/messages               │
│  - refresh       │                                     │
├─────────────────────────────────────────────────────────┤
│  Code Mode (4 meta-tools)     │  Starlark Sandbox      │
│  - listToolFiles               │  - Hermetic execution  │
│  - readToolFile                │  - Server injection    │
│  - getToolDocs                 │                        │
│  - executeToolCode             │                        │
├─────────────────────────────────────────────────────────┤
│  Registry (.pyi files)        │  OAuth2 (RFC 7591)     │
│  - servers/*.pyi               │  - Dynamic registration│
│  - Tool signatures             │  - Token storage       │
└─────────────────────────────────────────────────────────┘
         │                │                │
    ┌────┴────┐      ┌────┴────┐      ┌────┴────┐
    │ Server1 │      │ Server2 │      │ Server3 │
    │ (HTTP)  │      │ (SSE)   │      │ (Stdio) │
    └─────────┘      └─────────┘      └─────────┘

Licencia

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityNo data
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Server Proxy

    hr98w
    A
    license
    Not graded
    quality
    D
    maintenance
    Aggregates multiple MCP servers into a single endpoint, enabling LLM clients to access tools, resources, and prompts from various backends through one connection.
    9 npm
    MIT

  • ToolMux

    subnetangel
    A
    license
    B
    quality
    C
    maintenance
    Aggregates multiple MCP servers via a single interface with token optimization and multiple operating modes (Gateway, Meta, Proxy, Search, Code).
    7
    8
    MIT

  • MCPHub

    GW19ddd
    A
    license
    Not graded
    quality
    A
    maintenance
    Centralizes management and routing of multiple MCP servers, exposing them to AI clients via HTTP/SSE endpoints with configurable visibility, sharing, and smart routing.
    1,706 npm
    Apache 2.0

  • MCPHub

    XCyclone
    A
    license
    Not graded
    quality
    B
    maintenance
    Centralized management and routing of multiple MCP servers via unified Streamable HTTP/SSE endpoints, with granular group visibility, smart routing, and authentication.
    1,706 npm
    Apache 2.0