Master Mcp Server

What is Master Mcp Server?

Master Mcp Server aggregates multiple MCP servers behind a single, secure endpoint. It provides configuration-driven module loading, unified capability discovery, request routing with resilience, and first-class OAuth flows for multi-backend authentication. It is built for developers who need to manage, route, and secure multiple MCP backends from a single gateway.

How to use Master Mcp Server?

Install dependencies with npm ci, copy .env.example to .env, then run npm run dev. Use the HTTP gateway endpoints: POST /mcp/tools/list, POST /mcp/tools/call, POST /mcp/resources/list, POST /mcp/resources/read. Health check at GET /health and metrics at GET /metrics. Configuration is driven by JSON or YAML files with schema validation and secret resolution.

Key features of Master Mcp Server

• Aggregates multiple MCP servers with tool/resource discovery and namespacing
• OAuth support: master token pass-through, delegated provider flows, proxy refresh
• Config-driven setup with JSON/YAML, schema validation, and secret resolution
• Resilient routing: load-balancing, retries with backoff/jitter, circuit-breakers
• Cross-platform: Node.js server and Cloudflare Workers runtime
• Production-ready deployment: Docker, Cloudflare Workers, Koyeb

Use cases of Master Mcp Server

• Expose multiple MCP servers through a single unified endpoint with namespacing
• Manage authentication across several backends using delegated OAuth flows
• Route requests with load balancing, retries, and circuit-breakers for reliability
• Deploy as a Node.js server or a Cloudflare Worker for serverless use
• Configure and extend MCP aggregation via JSON/YAML config files

FAQ from Master Mcp Server

What is Master Mcp Server and what does it do?

Master Mcp Server aggregates multiple MCP servers behind a single secure endpoint, providing configuration-driven module loading, unified capability discovery, request routing with resilience, and OAuth flows for multi-backend authentication.

How do I install and run Master Mcp Server locally?

Run npm ci, copy .env.example to .env, then execute npm run dev. The server will start on the configured port.

What endpoints does Master Mcp Server expose?

It exposes health (GET /health), metrics (GET /metrics), and MCP HTTP gateway endpoints: POST /mcp/tools/list, POST /mcp/tools/call, POST /mcp/resources/list, and POST /mcp/resources/read.

How can I deploy Master Mcp Server?

It supports deployment via Docker (with Dockerfile and docker-compose.yml), Cloudflare Workers (with wrangler.toml), and Koyeb (with koyeb.yaml). CI/CD examples are available in the documentation.

Does Master Mcp Server support authentication?

Yes. It includes first-class OAuth support: master token pass-through, delegated provider flows, and proxy refresh.