MCP HTTP Gateway

Serveur HTTP qui expose n'importe quel serveur MCP (Model Context Protocol) en tant qu'API REST, sans modifier les MCPs eux-mêmes. Conçu pour permettre à des agents ou applications ne supportant pas nativement le protocole MCP de communiquer avec l'écosystème MCP via de simples requêtes HTTP.

Fonctionnement

Chaque MCP tourne en tant que processus enfant (transport stdio). Le gateway s'y connecte via le SDK MCP officiel et expose ses outils sur des routes HTTP configurables.

Agent / App externe
       │
       │  HTTP
       ▼
MCP HTTP Gateway (port 3500)
       │
       │  stdio (SDK MCP)
       ├──▶ mcp-documentor  (/documentor)
       ├──▶ mcp-raindrop     (/raindrop)
       └──▶ ...

Installation

En tant que CLI globale :

npm install -g mcp-http-gateway

Via npx (sans installation) :

npx mcp-http-gateway

En dépendance locale d'un projet :

npm install mcp-http-gateway

Configuration

.env

GATEWAY_PORT=3500

config/mcp-servers.json

À créer dans le répertoire courant depuis lequel tu lances le gateway (pas dans le package lui-même). Un fichier config/mcp-servers.example.json est disponible comme point de départ.

Même format que la configuration mcpServers de Cursor. Ajouter MCP_SERVER_ROUTE dans env pour définir la route HTTP du MCP, et description pour la documentation.

{
  "mcpServers": {
    "mon-mcp": {
      "command": "node",
      "args": ["/chemin/vers/dist/index.js"],
      "description": "Description courte du MCP",
      "env": {
        "MA_VARIABLE": "valeur",
        "MCP_SERVER_ROUTE": "/ma-route"
      }
    }
  }
}

Un MCP sans MCP_SERVER_ROUTE est ignoré au démarrage.

Démarrage

npm start

Le gateway connecte chaque MCP configuré et démarre le serveur HTTP. Les MCPs en échec au démarrage sont ignorés sans bloquer les autres.

Routes

GET /mcps

Retourne la liste des MCPs connectés avec leur route, description et instructions d'utilisation (format Markdown).

curl http://localhost:3500/mcps

GET /{route}/tools

Liste les outils disponibles d'un MCP avec leur nom, description et schéma d'arguments.

curl http://localhost:3500/documentor/tools

POST /{route}/tools/:toolName

Appelle un outil du MCP. Les arguments sont passés dans le body JSON.

curl -X POST http://localhost:3500/documentor/tools/list_projects -H "Content-Type: application/json" -d '{}'

curl -X POST http://localhost:3500/documentor/tools/get_doc -H "Content-Type: application/json" -d '{"id":"mon-doc-id"}'

Réponse

La réponse est le format brut du protocole MCP — un tableau content de blocs typés :

{
  "content": [
    { "type": "text", "text": "Résultat de l'outil..." }
  ]
}

Pour extraire le texte directement avec jq :

curl -s -X POST http://localhost:3500/documentor/tools/list_projects -H "Content-Type: application/json" -d '{}' | jq -r '.content[0].text'

Ajouter un MCP

1. Ajouter l'entrée dans config/mcp-servers.json avec MCP_SERVER_ROUTE dans env
2. Redémarrer le gateway

Aucune modification du MCP n'est nécessaire.