Mcgravity

🚀 McGravity Gravity Field

McGravity is a tool that connects multiple MCP (Model Context Protocol) servers into a unified service, enabling the reuse of the same MCP server and almost infinite expansion of underlying MCP server connections.

🚀 Quick Start

McGravity is a tool that integrates multiple MCP (Model Context Protocol) servers into a unified service. It allows you to reuse the same MCP server and scale the underlying MCP server connections almost infinitely. The current version is a basic CLI tool, but McGravity will evolve into a full-fledged MCP server proxy, similar to Nginx but for modern Gen AI tools and servers.

✨ Features

Why Choose McGravity?

Without McGravity:
┌─────────┐     ┌─────────┐
│  Client │────▶│MCP      │
│         │     │Server 1 │
└─────────┘     └─────────┘
    │
    │           ┌─────────┐
    └──────────▶│MCP      │
                │Server 2 │
                └─────────┘

With McGravity:
┌─────────┐     ┌─────────┐     ┌─────────┐
│  Client │────▶│McGravity│────▶│MCP      │
│         │     │         │     │Server 1 │
└─────────┘     └─────────┘     └─────────┘
                     │
                     │          ┌─────────┐
                     └─────────▶│MCP      │
                                │Server 2 │
                                └─────────┘

📦 Installation

Install McGravity using the following command:

bun add mcgravity

💻 Usage Examples

Basic Usage

mcgravity --help

Configuration

Create a mcgravity.config.ts file in the project root directory with the following content:

// mcgravity.config.ts
export default {
  port: 3000,
  upstreamUrl: 'http://localhost:5000'
}

Testing

Run Tests

Run the following command to execute all tests:

bun test

Run the following command to execute only integration tests:

bun test:integration

📚 Documentation

Future Plans

McGravity will expand with the following features:

• Web interface for monitoring
• Advanced load balancing
• MCP server health checks
• Authentication and access control
• Plugin system for custom integrations

Development

TypeScript and Code Style

This project uses:

• TypeScript and runs on the Bun runtime
• ESLint for code linting with TypeScript-specific rules
• Prettier for code formatting

Run the following commands:

# Format code using Prettier
bun run format

# Check if the code is correctly formatted
bun run format:check

# Lint code using ESLint
bun run lint

# Fix auto-fixable ESLint issues
bun run lint:fix

VS Code is configured to automatically format the code on save and provides linting information after installing the recommended plugins.

🔧 Technical Details

Contribution

Contributions are welcome! Feel free to open an issue or submit a pull request.