Mcgravity

🚀 McGravity 重力場

McGravity 是一款強大的工具，它能將多個 MCP（模型上下文協議）服務器整合為統一服務。藉助它，用戶可重複利用同一 MCP 服務器，還能近乎無限地擴展底層的 MCP 服務器連接。當前雖只是基礎的 CLI 工具，但未來將發展成完整的 MCP 服務器代理，就像 Gen AI 領域的 Nginx。

🚀 快速開始

McGravity 能讓你輕鬆連接多個 MCP 服務器，以下是使用前的安裝和基本配置。

✨ 主要特性

• 服務器整合：將多個 MCP 服務器連接成一個統一服務，方便管理和使用。
• 無限擴展：可重複使用同一 MCP 服務器，並幾乎無限擴展底層的 MCP 服務器連接。
• 未來可期：後續將添加 Web 界面監控、高級負載均衡、健康檢查、認證和訪問控制、插件系統等功能。

📦 安裝指南

使用以下命令安裝 McGravity：

bun add mcgravity

💻 使用示例

基本用法

查看幫助信息：

mcgravity --help

配置

在項目根目錄中創建一個 mcgravity.config.ts 文件，內容如下：

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

📚 詳細文檔

測試

運行測試

運行以下命令以執行所有測試：

bun test

運行以下命令以僅執行集成測試：

bun test:integration

未來計劃

McGravity 將會擴展以下功能：

• Web 界面用於監控
• 高級負載均衡
• MCP 服務器健康檢查
• 認證和訪問控制
• 插件系統用於自定義集成

開發

TypeScript 和代碼風格

此項目使用：

• TypeScript 並基於 Bun 運行時
• ESLint 用於代碼檢查，帶有 TypeScript 特定規則
• Prettier 用於代碼格式化

運行以下命令：

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

# 檢查代碼是否正確格式化
bun run format:check

# 使用 ESLint 檢查代碼
bun run lint

# 修復可自動修正的 ESLint 問題
bun run lint:fix

VS Code 配置為保存時自動格式化代碼，並在安裝推薦插件後提供代碼檢查信息。

貢獻

歡迎貢獻！請隨意提出問題或提交拉取請求。