Mcgravity

🚀 McGravity 重力场

McGravityは、複数のMCP（モデルコンテキストプロトコル）サーバーを統一されたサービスに接続するツールです。同じMCPサーバーを再利用し、基盤となるMCPサーバー接続をほぼ無制限に拡張することができます。

🚀 クイックスタート

McGravityは、現在基本的なCLIツールとして提供されていますが、将来的には完全なMCPサーバープロキシに発展する予定です。これは、現代のGen AIツールとサーバーに対するNginxのような存在になります。

✨ 主な機能

• 複数のMCPサーバーを統一的に管理できます。
• 同一のMCPサーバーを再利用し、接続を拡張できます。
• 将来的にはWebインターフェースや高度な負荷分散機能などが追加されます。

なぜMcGravityを選ぶのか？

McGravityを使用しない場合

┌─────────┐     ┌─────────┐
│ クライアント  │────▶│MCP      │
│         │     │サーバー 1 │
└─────────┘     └─────────┘
    │
    │           ┌─────────┐
    └──────────▶│MCP      │
                │サーバー 2 │
                └─────────┘

McGravityを使用する場合

┌─────────┐     ┌─────────┐     ┌─────────┐
│ クライアント  │────▶│McGravity│────▶│MCP      │
│         │     │         │     │サーバー 1 │
└─────────┘     └─────────┘     └─────────┘
                     │
                     │          ┌─────────┐
                     └─────────▶│MCP      │
                                │サーバー 2 │
                                └─────────┘

📦 インストール

以下のコマンドを使用して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は、保存時に自動的にコードをフォーマットするように設定されており、推奨プラグインをインストールするとコードチェック情報を提供します。

🤝 貢献

貢献を歓迎します！自由に問題を提起したり、プルリクエストを送信したりしてください。