1MCP: agregar varios servidores MCP con 1mcp serve

Para quién

1MCP es para quien quiere reunir varios servidores MCP en un runtime. Oficialmente: 1MCP is the unified MCP runtime, 1mcp serve aggregates your MCP servers. CLI mode da a Codex, Claude, Cursor y similar tool-using agents un flujo proxy más delgado.

Te encaja mejor si puedes instalar un paquete npm en global y aceptas añadir primero context7 según el ejemplo oficial, luego arrancar 1mcp serve. El primer intento es descubrimiento de solo lectura: llama 1mcp instructions.

No encaja si aún no tienes Node/npm y quieres saltarte la instalación e inventar backends, o si en el primer intento quieres 1mcp run de una herramienta no comprobada. Las notas oficiales no dan JSON de ejemplo para --args.

Primera prueba en 3 minutos

Requisito: esta máquina tiene npm. La vía principal oficial son estos tres pasos. No cambies de instalador:

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

La ubicación de instalación es @1mcp/agent global. Cuando serve esté arriba, los clientes HTTP pueden conectar con el fragmento oficial a: http://127.0.0.1:3050/mcp?app=cursor

La primera llamada usa 1mcp instructions. Pertenece a CLI mode for progressive discovery, para tomar notas de uso, y es de menor riesgo que 1mcp run. No pases parámetros que no aparecen.

Éxito: vuelve un texto de instructions que dice cómo seguir con inspect o run. Esto levanta un runtime de agregación en esta máquina y, según el ejemplo, trae @upstash/context7-mcp por npx. No es «sin red ni proceso local».

Si serve no arranca, confirma primero que el comando 1mcp global funciona y que mcp add ya añadió context7. No trates 1mcp cli-setup --codex como la única instalación.

Casos de uso

Caso 1: primero leer las notas de descubrimiento. Con serve ya en marcha, ejecuta 1mcp instructions. Usa el texto devuelto para confirmar que el canal de descubrimiento CLI funciona. No pases --args en este paso.

Caso 2: ver qué hay dentro de un backend. Oficial: 1mcp inspect <server> y 1mcp inspect <server>/<tool>. Contra context7 del ejemplo oficial, ejecuta 1mcp inspect context7. Éxito: ves la información de herramientas de ese server. Solo después de que inspect te haya dado un nombre de herramienta real, considera 1mcp run <server>/<tool> --args. Las notas originales no dan una muestra JSON. No hagas run en el primer intento.

Límites de uso

1mcp serve agrega los servidores MCP que añades y ofrece HTTP en 127.0.0.1:3050. app=cursor es solo la cadena de consulta de ejemplo oficial. No obliga a ese cliente.

1mcp cli-setup --codex es otro cableado para CLI mode, no un segundo canal de instalación de paquete. 1mcp run ejecuta de verdad una herramienta backend. Los efectos secundarios dependen del servidor agregado. No hay una vía de deshacer unificada. No inventes nombres de backend distintos de instructions, inspect, run y context7 del ejemplo.