Skip to main content
Glama

Master MCP Server

by Jakedismo

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)

  1. Install dependencies (requires network):
npm ci
  1. Configure environment (copy and edit):
cp .env.example .env
  1. Run in dev mode:
npm run dev
  1. Health and Metrics:
  • GET /health{ ok: true }
  • GET /metrics → basic system metrics
  1. 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.

  1. Install (requires network):
npm i -D typedoc typedoc-plugin-markdown
  1. Generate docs:
npm run docs:api

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 and docs/examples/testing.md

Each example has a README with run instructions.

Deployment

  • Docker: deploy/docker/* and top-level Dockerfile / docker-compose.yml
  • Cloudflare Workers: deploy/cloudflare/* with wrangler.toml
  • Koyeb: deploy/koyeb/koyeb.yaml
  • CI/CD examples: see docs/deployment/cicd.md

Architecture

MCP Master 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.

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Highlights
    1. Quick Start (Node.js)
      1. Documentation
        1. Generate API Docs
          1. Examples
            1. Deployment
              1. Architecture
                1. Contributing & Support
                  1. License

                    Related MCP Servers

                    • -
                      security
                      A
                      license
                      -
                      quality
                      A middleware server that enables multiple isolated instances of the same MCP servers to coexist independently with unique namespaces and configurations.
                      Last updated -
                      17
                      70
                      MIT License
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A 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 -
                      7
                      156
                      MIT License
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      Run 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 -
                      198
                      10,139
                      • Linux
                      • Apple
                    • -
                      security
                      F
                      license
                      -
                      quality
                      Proxy that aggregates multiple MCP servers and presents them as a unified interface, allowing clients to access resources from multiple servers transparently.
                      Last updated -
                      5

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jakedismo/master-mcp-server'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server