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.
Highlights
- 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
- Testing strategy and CI-ready structure
Quick Start (Node.js)
- Install dependencies (requires network):
- Configure environment (copy and edit):
- Run in dev mode:
- Health and Metrics:
GET /health
→{ ok: true }
GET /metrics
→ basic system metrics
- MCP endpoints (HTTP gateway):
POST /mcp/tools/list
POST /mcp/tools/call
with{ name, arguments }
POST /mcp/resources/list
POST /mcp/resources/read
with{ uri }
See docs/
for full guides and end-to-end examples.
Documentation
- Docs index:
docs/index.md
- Getting started:
docs/getting-started/overview.md
- Guides:
docs/guides/*
- API reference: generated into
docs/api/reference/
(see below) - Configuration reference:
docs/configuration/*
- Deployment:
docs/deployment/*
- Troubleshooting:
docs/troubleshooting/*
- Contributing:
docs/contributing/*
Generate API Docs
We use TypeDoc (Markdown) to generate API docs from TypeScript.
- Install (requires network):
- Generate docs:
Outputs to docs/api/
.
Examples
Working examples live in examples/
:
- Basic Node:
examples/basic-node
- Cloudflare Worker:
examples/cloudflare-worker
- Advanced Routing:
examples/advanced-routing
- OAuth Delegation:
examples/oauth-delegation
- Testing Patterns: see
/tests
anddocs/examples/testing.md
Each example has a README with run instructions.
Deployment
- Docker:
deploy/docker/*
and top-levelDockerfile
/docker-compose.yml
- Cloudflare Workers:
deploy/cloudflare/*
withwrangler.toml
- Koyeb:
deploy/koyeb/koyeb.yaml
- CI/CD examples: see
docs/deployment/cicd.md
Architecture
Contributing & Support
- See
docs/contributing/*
for development workflow and guidelines - See
docs/troubleshooting/index.md
for solutions - Open an issue or discussion for help and ideas
License
See LICENSE
. This repository currently uses UNLICENSED for private/internal use.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Aggregates multiple MCP servers behind a single, secure endpoint with unified tool/resource discovery, OAuth authentication, and resilient request routing. Enables users to manage and interact with multiple MCP backends through one centralized interface with load balancing and circuit breakers.
Related MCP Servers
- -securityAlicense-qualityA middleware server that enables multiple isolated instances of the same MCP servers to coexist independently with unique namespaces and configurations.Last updated -1770MIT License
- AsecurityAlicenseAqualityA central hub that aggregates multiple MCP resource servers into a single unified interface, enabling users to access tools and capabilities from multiple backend servers through one connection point.Last updated -4156MIT License
Pipedreamofficial
-securityFlicense-qualityRun your own MCP server for over 2,500 apps and APIs. * Run your own MCP server for over 2,500 APIs * Manage servers for your users, in your own app. * Connect accounts, configure params, and make API requests, all via tools * Fully-managed OAuth and credential storage )Last updated -19810,139