1MCP : agréger plusieurs serveurs MCP avec 1mcp serve

Pour qui

1MCP s'adresse à qui veut ramener plusieurs serveurs MCP en un seul runtime. Officiellement : 1MCP is the unified MCP runtime, 1mcp serve aggregates your MCP servers. CLI mode donne à Codex, Claude, Cursor et similar tool-using agents un flux proxy plus mince.

Cela vous convient mieux si vous pouvez installer un paquet npm en global, et acceptez d'ajouter d'abord context7 selon l'exemple officiel, puis de démarrer 1mcp serve. Le premier essai est une découverte en lecture seule : appeler 1mcp instructions.

Cas inadaptés : vous n'avez pas encore Node/npm et voulez sauter l'installation et inventer des backends, ou vous voulez 1mcp run un outil non vérifié dès le premier essai. Les notes officielles ne donnent pas de JSON d'exemple pour --args.

Premier essai en 3 minutes

Prérequis : cette machine a npm. Le chemin principal officiel est ces trois étapes. Ne pas changer d'installateur :

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

L'emplacement d'installation est @1mcp/agent en global. Une fois serve levé, les clients HTTP peuvent se connecter avec le fragment officiel à : http://127.0.0.1:3050/mcp?app=cursor

Le premier appel utilise 1mcp instructions. Il appartient à CLI mode for progressive discovery, pour prendre les notes d'usage, et est moins risqué que 1mcp run. Ne pas passer de paramètres absents.

Succès : un texte d'instructions revient et dit comment continuer inspect ou run. Cela démarre un runtime d'agrégation sur cette machine et, selon l'exemple, tire @upstash/context7-mcp via npx. Ce n'est pas « hors réseau, sans processus local ».

Si serve ne démarre pas, d'abord confirmer que la commande 1mcp globale marche et que mcp add a déjà ajouté context7. Ne pas traiter 1mcp cli-setup --codex comme la seule installation.

Cas d'usage

Cas 1 : d'abord lire les notes de découverte. Serve déjà en cours, exécuter 1mcp instructions. Utiliser le texte renvoyé pour confirmer que le canal de découverte CLI marche. Ne pas passer --args à cette étape.

Cas 2 : voir ce qu'il y a dans un backend. Officiel : 1mcp inspect <server> et 1mcp inspect <server>/<tool>. Sur context7 de l'exemple officiel, exécuter 1mcp inspect context7. Succès : informations d'outils de ce server. Seulement après qu'inspect a donné un vrai nom d'outil, envisager 1mcp run <server>/<tool> --args. Les notes d'origine ne donnent pas d'échantillon JSON. Ne pas run au premier essai.

Limites d'usage

1mcp serve agrège les serveurs MCP ajoutés et fournit HTTP sur 127.0.0.1:3050. app=cursor n'est que la chaîne de requête d'exemple officielle. Cela n'impose pas ce client.

1mcp cli-setup --codex est un autre câblage pour CLI mode, pas un second canal d'installation de paquet. 1mcp run exécute vraiment un outil backend. Les effets de bord dépendent du serveur agrégé. Pas de chemin d'annulation unifié. N'inventez pas d'autres noms de backend que instructions, inspect, run et context7 de l'exemple.