McGravity

<div align="center"> <img src="./assets/thumbnail.png" alt="McGravity Thumbnail" width="400"> </div>

关于

McGravity 是一个将多个 MCP (机器通信协议) 服务器连接成一个统一服务的工具。它允许您重用相同的 MCP 服务器，并几乎无限地扩展底层 MCP 服务器连接。

当前版本作为一个基本的 CLI 工具运行，但 McGravity 将发展成为一个功能齐全的 MCP 服务器代理 - 就像 Nginx，但用于现代 Gen AI 工具和服务器。

为什么选择 McGravity？

没有 McGravity:
┌─────────┐     ┌─────────┐
│ 客户端  │────▶│MCP      │
│         │     │服务器 1 │
└─────────┘     └─────────┘
    │
    │           ┌─────────┐
    └──────────▶│MCP      │
                │服务器 2 │
                └─────────┘

使用 McGravity:
┌─────────┐     ┌─────────┐     ┌─────────┐
│ 客户端  │────▶│McGravity│────▶│MCP      │
│         │     │         │     │服务器 1 │
└─────────┘     └─────────┘     └─────────┘
                     │
                     │          ┌─────────┐
                     └─────────▶│MCP      │
                                │服务器 2 │
                                └─────────┘

McGravity 解决了以下问题：

• 通过一个端点连接到多个 MCP 服务器
• 在 MCP 服务器之间平衡负载
• 为您的应用程序提供单一的访问点

安装

# 安装依赖
bun install

# 将项目构建成单个可执行文件
bun build src/index.ts --compile --outfile mcgravity

Docker

McGravity 在 Docker Hub 上可用：tigranbs/mcgravity。

docker pull tigranbs/mcgravity

# 基本用法
docker run -p 3001:3001 tigranbs/mcgravity http://mcp1.example.com http://mcp2.example.com

# 使用自定义主机和端口
docker run -p 4000:4000 tigranbs/mcgravity --host 0.0.0.0 --port 4000 http://mcp1.example.com

用法

基本命令：

./mcgravity <mcp-server-address1> <mcp-server-address2> ...

带选项：

./mcgravity --host localhost --port 3001 http://mcp1.example.com http://mcp2.example.com

使用配置文件：

./mcgravity --config config.yaml

选项

• --host <host>: 服务器绑定的主机 (默认: localhost)
• --port <port>: 服务器绑定的端口 (默认: 3001)
• --config <path>: 配置文件的路径 (默认: config.yaml)
• --mcp-version <version>: MCP 服务器的版本 (默认: 1.0.0)
• --mcp-name <name>: MCP 服务器的名称 (默认: mcgravity)
• --help: 显示帮助信息

配置

McGravity 可以使用 YAML 文件进行配置。有关示例配置，请参见 config.example.yaml：

name: mcgravity
version: 1.0.0
description: A simple MCP server

servers:
  echo-server:
    url: http://localhost:3000/sse
    name: echo-server
    version: 1.0.0
    description: A simple echo server
    tags:
      - echo

您可以运行包含的 echo server 示例进行测试：

# 首先启动 echo server
bun examples/echo-server.ts

# 然后启动 McGravity 指向 echo server
./mcgravity --config config.yaml

示例

使用默认设置启动 McGravity：

./mcgravity http://mcp1.example.com http://mcp2.example.com

指定主机和端口：

./mcgravity --host 0.0.0.0 --port 4000 http://mcp1.example.com http://mcp2.example.com

运行测试

要运行所有测试：

bun test

仅运行集成测试：

bun run test:integration

集成测试

集成测试验证 McGravity 是否可以：

1. 连接到 MCP 服务器（示例 echo server）
2. 正确代理目标 MCP 服务器的功能
3. 将来自客户端的请求传递到目标 MCP 服务器并返回响应

有关测试套件的更多详细信息，请参见 test README。

这些测试会在 push 和 PR 事件时自动在 GitHub Actions CI 中运行。

未来计划

McGravity 将扩展到包括：

• 用于监控的 Web 界面
• 高级负载均衡
• MCP 服务器健康检查
• 身份验证和访问控制
• 用于自定义集成的插件系统

开发

TypeScript 和代码风格

本项目使用：

• 带有 Bun 运行时的 TypeScript
• ESLint 用于代码检查，带有特定于 TypeScript 的规则
• Prettier 用于代码格式化

该配置针对 Bun 进行了优化，并具有适用于运行时环境的适当 TypeScript 设置。

运行以下命令：

# 使用 Prettier 格式化代码
bun run format

# 检查代码是否已正确格式化
bun run format:check

# 使用 ESLint 检查代码
bun run lint

# 修复可自动修复的 linting 问题
bun run lint:fix

VS Code 配置为在保存时格式化代码，并在安装推荐的扩展时提供 linting 信息。

贡献

欢迎贡献！ 随意打开 issue 或提交 pull request。