mcp-registry/mcgravity

    ==================
      
       /// MCP ///
      /// MCG ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcgravity

by tigranbs

CLI/Docker proxy that aggregates and load-balances multiple Model Context Protocol (MCP) servers behind one endpoint, acting like Nginx for Gen-AI back-ends.

63
3
Open Source
GitHubDocumentation

01

mcgravity

CLI executable that starts the McGravity proxy, connecting and load-balancing one or more MCP servers

02

--host

Flag that sets the host address McGravity should bind to (default: localhost)

03

--port

Flag that sets the port McGravity should listen on (default: 3001)

04

--config

Flag that supplies a YAML configuration file for McGravity (default: config.yaml)

05

--mcp-version

Flag that specifies the MCP protocol version McGravity should advertise (default: 1.0.0)

06

--mcp-name

Flag that sets the MCP server name McGravity will report (default: mcgravity)

07

--help

Flag that displays help information for the McGravity CLI

Installation

1. Prerequisites
• Node.js ≥ 18
• Git
2. Clone the repository
git clone https://github.com/tigranbs/mcgravity.git cd mcgravity
3. Install dependencies
npm install # or: pnpm install / yarn install
4. Build TypeScript → JavaScript
npm run build # a dist/ folder will be produced
5. Configure backend MCP servers
Create a file called gravity.config.json (or set env vars). Example gravity.config.json { "servers": [ "http://mcp-node-1.internal:8080", "http://mcp-node-2.internal:8080" ], "healthCheckInterval": 3000, "listenPort": 3000 } # Alternatively export env vars export GRAVITY_SERVERS="http://mcp-1:8080,http://mcp-2:8080" export GRAVITY_PORT=3000
6. Run the proxy
npm start # runs dist/index.js # or, during development npx ts-node src/index.ts
7. Verify
curl http://localhost:3000/v1/status # should proxy to a healthy MCP backend

Documentation

License: Apache License 2.0
Updated 7/30/2025