1MCP

Un servidor MCP unificado que agrega múltiples servidores MCP en un único punto final.

Documentación

1MCP

1MCP es el runtime unificado de MCP. 1mcp serve agrega tus servidores MCP, y el modo CLI añade un flujo de trabajo más ligero orientado a agentes para Codex, Claude, Cursor y agentes similares que usan herramientas.

Por qué 1MCP

La mayoría de las configuraciones de MCP eventualmente encuentran dos tipos de dispersión:

Dispersión de configuración: cada cliente necesita su propio cableado de MCP, opciones de autenticación y reglas de filtrado.
Dispersión de agentes: las sesiones autónomas cargan demasiadas herramientas y esquemas en el contexto de antemano.

1MCP aborda ambos:

1mcp serve te da un runtime agregado frente a muchos servidores MCP.
El modo CLI permite a los agentes descubrir herramientas progresivamente con instructions, inspect y run.
Los servidores estáticos pueden cargarse al inicio, mientras que los servidores de plantilla se crean a partir del contexto por cliente o por sesión.
Los ajustes preestablecidos, los filtros y la agregación de instrucciones mantienen el mismo runtime adaptable entre clientes y proyectos.

Enfoque	Mejor para	Compensación
Modo CLI de 1MCP	Codex, Claude, bucles de agentes	Requiere una instancia de `1mcp serve` en ejecución
Proxy stdio de 1MCP	Máxima compatibilidad entre clientes	Aún depende de `serve`, y los clientes HTTP con capacidad de autenticación tienen una ruta más directa
HTTP directo transmisible	Clientes HTTP nativos de MCP	Sin contexto de proyecto, sin `.1mcprc`, y se expone directamente una superficie de herramientas más amplia
Proxy personalizado	Adaptadores de compatibilidad puntuales	Tú controlas el descubrimiento, el filtrado, la autenticación y el ciclo de vida del runtime

Inicio rápido para usuarios de agentes

Esta página está optimizada para usuarios de agentes de IA. El resultado en 5 minutos es simple: inicia un runtime real de 1mcp serve, conecta tu agente con cli-setup, y luego verifica el flujo de trabajo de instructions -> inspect -> run.

Instala 1MCP, agrega un servidor ascendente y inicia el runtime:

npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve

En una segunda terminal, conecta tu agente al modo CLI:

1mcp cli-setup --codex
# or
1mcp cli-setup --claude --scope repo --repo-root .

Luego verifica el flujo de trabajo del agente:

# shell 1
1mcp serve

# shell 2
1mcp instructions
1mcp inspect context7
1mcp inspect context7/query-docs
1mcp run context7/query-docs --args '{"libraryId":"/mongodb/docs","query":"aggregation pipeline"}'

Si quieres el tutorial completo (con criterios de éxito y salidas), usa la Guía de inicio rápido.

Para un agente dado, elige solo un modo. Si cambias ese agente al modo CLI, elimina primero su antigua configuración directa de MCP.

Por qué existe el modo CLI

El modo CLI es el flujo de trabajo principal para sesiones estilo agente. Mantiene MCP como protocolo de backend pero reduce lo que el agente ve en cada paso:

instructions explica el runtime actual y el flujo recomendado
inspect permite al agente descubrir solo el servidor o herramienta que necesita
run ejecuta una herramienta seleccionada después de la inspección del esquema

Eso da a los bucles de agentes una superficie de trabajo más pequeña sin renunciar al runtime unificado detrás de 1mcp serve.

Elige otro camino

Proxy stdio

Usa 1mcp proxy cuando quieras la máxima compatibilidad de clientes sin renunciar al contexto del proyecto.

Es la alternativa recomendada después del modo CLI porque:

funciona con el transporte stdio que la mayoría de los clientes de IA ya soportan
mantiene el contexto del proyecto a través de .1mcprc
soporta servidores MCP de plantilla resueltos desde el contexto del proyecto o de la sesión
es más fácil de implementar con una configuración global única más configuración por proyecto

El modo stdio directo no es la ruta recomendada. Es principalmente útil para depuración porque el inicio de 1MCP es más lento que una configuración stdio independiente ligera.

Adjunto directo de MCP

El adjunto directo de MCP aún es compatible para clientes que quieren hablar con el runtime agregado a través de HTTP transmisible.

Ejemplos:

{
  "mcpServers": {
    "1mcp": {
      "url": "http://127.0.0.1:3050/mcp?app=cursor"
    }
  }
}

claude mcp add -t http 1mcp "http://127.0.0.1:3050/mcp?app=claude-code"

Usa esta ruta si tu cliente ya habla MCP de forma nativa, puede trabajar sin contexto de proyecto y no quieres el modo CLI. Para Codex, Claude, Cursor y bucles de agentes similares, prefiere primero el modo CLI y proxy en segundo lugar.

Operadores de runtime

Usa la documentación más profunda si estás configurando o desplegando el runtime en sí:

Contribuyentes

Cómo funciona

flowchart LR
    A[User or Agent] --> B[1mcp serve]
    B --> C[Static servers loaded at startup]
    B --> D[Template servers resolved from client or session context]
    A --> E[CLI mode: instructions -> inspect -> run]
    E --> B
    F[Direct streamable HTTP client] --> B
    G[stdio-compatible client] --> H[1mcp proxy]
    H --> B

1MCP se ejecuta como un runtime agregado detrás de 1mcp serve. Los servidores estáticos se preparan a partir de la configuración de inicio, los servidores de plantilla se materializan cuando se conoce el contexto del cliente, y el runtime puede usar carga asíncrona para disponibilidad temprana del listener HTTP y carga diferida para una superficie de herramientas estable. La agregación de instrucciones, los ajustes preestablecidos y las notificaciones se sitúan junto a ese runtime en lugar de fuera de él.

La carga diferida es un modo de compatibilidad de superficie de herramientas estable opcional. Mantiene la superficie de descubrimiento e invocación del backend en tool_list, tool_schema y tool_invoke para que los agentes capaces puedan descubrir herramientas progresivamente sin reemplazar su tabla de herramientas MCP. Cualquier herramienta de gestión interna explícitamente habilitada permanece expuesta directamente. La carga diferida reduce la carga útil inicial del esquema, pero no reduce las conexiones o procesos del backend, no hace que el inicio síncrono se vincule antes, ni repara procesos proxy huérfanos. Consulta #392 para el contrato de visibilidad de servidores tardíos asíncronos.

Capacidades principales

Runtime unificado para muchos servidores MCP detrás de un proceso serve
Modo CLI para descubrimiento progresivo con 1mcp instructions, 1mcp inspect <server>, 1mcp inspect <server>/<tool> y 1mcp run <server>/<tool> --args '<json>'
Servidores de plantilla para resolución por cliente o por sesión
Carga asíncrona opcional para disponibilidad temprana del listener HTTP cuando los clientes pueden reconciliar cambios de capacidades
Carga diferida opcional para una superficie de herramientas de descubrimiento progresivo estable y esquemas iniciales más pequeños
Recuperación automática opcional para backends stdio propios, con visibilidad de salud/estado y controles de reinicio del operador
Agregación de instrucciones entre servidores estáticos y respaldados por plantillas
Ajustes preestablecidos, filtros y notificaciones de cambios de ajustes preestablecidos
proxy para máxima compatibilidad con contexto de proyecto y soporte de servidores de plantilla
Acceso MCP HTTP transmisible directo para clientes HTTP nativos que no necesitan contexto de proyecto

Casos de uso comunes

Dale a un agente de codificación un runtime estable pero una superficie de trabajo más pequeña.
Comparte el mismo inventario de MCP entre Cursor, Claude Code, Codex y herramientas internas.
Expón servidores de plantilla específicos del contexto por repositorio, rama o sesión.
Centraliza autenticación, filtrado, ajustes preestablecidos y ciclo de vida del runtime en lugar de reconstruirlos en scripts ad hoc.

Contribuciones / Licencia

Las contribuciones son bienvenidas. Consulta CONTRIBUTING.md para el flujo de trabajo de desarrollo y LICENSE para la licencia Apache 2.0.