mcp-gateway

MCP server registry with workspace bindings and tool catalog.

Part of the Urule ecosystem — the open-source coordination layer for AI agents.

• Server registry -- register, list, and remove MCP servers with support for stdio, sse, and streamable-http transports
• Workspace bindings -- bind MCP servers to workspaces so agents only see the tools available in their context
• Tool catalog -- register tools per server, search across all tools, and look up by server or keyword
• Fastify REST API with health check, structured error handling, and request ID tracking
• Drizzle ORM schemas ready for PostgreSQL persistence (in-memory by default for development)
• Designed for the Model Context Protocol specification

npm install
npm run build
npm start

Or for development with hot reload:

npm run dev

The server starts on port 3000 by default.

curl -X POST http://localhost:3000/api/v1/mcp/servers \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "filesystem",
    "description": "File system access",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
    "transportType": "stdio"
  }'

curl -X POST http://localhost:3000/api/v1/mcp/bindings \
  -H 'Content-Type: application/json' \
  -d '{"workspaceId": "ws-1", "serverId": "SERVER_ID"}'

curl http://localhost:3000/api/v1/workspaces/ws-1/mcp/tools

| Method | Path | Description | |---|---|---| | GET | /api/v1/mcp/servers | List all registered MCP servers | | POST | /api/v1/mcp/servers | Register a new MCP server | | GET | /api/v1/mcp/servers/:serverId | Get server by ID | | DELETE | /api/v1/mcp/servers/:serverId | Remo