Remote MCP

🚀 リモート-MCP プロジェクトドキュメント

リモート-MCP は、リモートモデルコンテキストプロトコルのソリューションです。これにより、モデルコンテキストのリモートアクセスと集中管理が可能になります。

📑 目次

1. リモート-MCP の概要
2. アーキテクチャ設計
3. なぜこのライブラリが必要なのか？
4. 使い始める方法
   • クライアントの設定
   • サーバー側の実装
5. 既存のパッケージ依存関係
6. 将来の開発ロードマップ
7. 貢献する方法
8. 免責事項
9. ライセンス
10. 参考資料

リモート-MCP の概要

リモート-MCP は、リモートモデルコンテキストプロトコルのソリューションで、リモートアクセスとモデルコンテキストの集中管理を実現することを目的としています。これは型安全で双方向の通信フレームワークで、カスタムヘッダーと基本的な認証ミドルウェアをサポートしています。

アーキテクチャ設計

核心コンポーネント

1. @remote-mcp/client：クライアントライブラリで、ローカルの MCP サービスとして動作し、リモート実装に接続します。
2. @remote-mcp/server：サーバー側のライブラリで、リモートアクセス可能な MCP サービスを作成するために使用されます。

機能特徴

• 基本的な型安全なクライアント/サーバー通信。
• 基本的な MCP コマンド、ツール、およびヒント機能をサポート。
• HTTP ヘッダーのサポート（カスタムヘッダーと認証ミドルウェアを含む）。
• 初期的なエラー処理の改善と基本的なミドルウェアサポート。

アーキテクチャ例

以下は、リモート-MCP のアーキテクチャ例の図です。

なぜこのライブラリが必要なのか？

現在の MCP 実装はローカル使用に限定されており、リモートアクセスと集中管理のニーズを満たすことができません。リモート-MCP はこの問題を解決し、モデルコンテキストプロトコルに拡張性を提供し、より高度な機能をサポートします。

使い始める方法

クライアントの設定

1. クライアントパッケージのインストール：

   npm install @remote-mcp/client
   

2. ローカルの MCP サービスの作成：

   import { MCPRouter, LogLevel } from "@remote-mcp/client";
   
   const mcpRouter = new MCPRouter({
     logLevel: LogLevel.DEBUG,
     name: "example-client",
     version: "1.0.0",
   });
   
   // カスタムツールまたはコマンドの追加
   mcpRouter.addTool(
     "calculator",
     {
       description: "Perform basic calculations.",
       schema: z.object({
         operation: z.enum(["add", "subtract", "multiply", "divide"]),
         a: z.string(),
         b: z.string(),
       }),
     },
     async (args) => {
       // 計算ロジックの処理
       return {
         content: [{ type: "text", text: `${result}` }],
       };
     }
   );
   
   // サービスの起動
   mcpRouter.listen(9512);
   

サーバー側の実装

1. サーバーパッケージのインストール：

   npm install @remote-mcp/server
   

2. リモートの MCP サービスの作成：

   import { MCPRouter, LogLevel } from "@remote-mcp/server";
   import { createHTTPServer } from '@trpc/server/adapters/standalone';
   
   const mcpRouter = new MCPRouter({
     logLevel: LogLevel.DEBUG,
     name: "example-server",
     version: "1.0.0",
     capabilities: {
       logging: {},
     },
   });
   
   // サンプルツールの追加
   mcpRouter.addTool(
     "calculator",
     {
       description:
         "Perform basic calculations. Add, subtract, multiply, divide.",
       schema: z.object({
         operation: z.enum(["add", "subtract", "multiply", "divide"]),
         a: z.string(),
         b: z.string(),
       }),
     },
     async (args) => {
       const a = Number(args.a);
       const b = Number(args.b);
   
       switch (args.operation) {
         case "add":
           return { content: [{ type: "text", text: `${a + b}` }] };
         case "subtract":
           return { content: [{ type: "text", text: `${a - b}` }] };
         // 他の操作...
       }
     }
   );
   
   // HTTP サービスの起動
   createHTTPServer({
     router: mcpRouter,
   }).start({ port: 9512 });
   

既存のパッケージ依存関係

• @remote-mcp/client：クライアント通信に使用されます。
• @remote-mcp/server：サーバー側の実装に使用されます。
• trpc：TRPC ベースのリモートプロシージャコールをサポートします。

将来の開発ロードマップ

予定機能

1. エラー処理の改善：エラー処理メカニズムを改善し、ユーザー体験を向上させます。
2. より多くのプロトコルのサポート：より多くの通信プロトコルのサポートを拡張します。
3. セキュリティの強化：SSL サポートやトークン検証など、より多くのセキュリティ機能を追加します。

貢献する方法

コミュニティメンバーの参加を歓迎します！

• 問題報告の提出：GitHub Issues
• コード修正や新機能の提出：Pull Request

免責事項

このプロジェクトは実験的なものであり、本番環境での使用には適していません。使用する前に、ドキュメントをよく読み、十分なテストを行ってください。

ライセンス

このプロジェクトは MIT ライセンスに従います。詳細な条項は LICENSE ファイル を参照してください。

参考資料

1. MCP プロトコルドキュメント：リンク
2. TRPC ドキュメント：リンク

ありがとうございました！詳細を知りたい場合は、プロジェクトの GitHub リポジトリを訪問するか、関連ドキュメントを参照してください。