Pluggedin MCP Proxy

🚀 plugged.in モデルコンテキストプロトコル（MCP）プロキシサーバ

このプロジェクトは、「plugged.in MCP Proxy Server」という名前のプロジェクトで、モデルコンテキストプロトコル（Model Context Protocol, MCP）クライアントにサービスを提供することを目的としています。このプロキシサーバは、複数の基盤となるMCPサーバに接続し、統一インターフェースを通じてそれらの能力（ツール、リソース、プロンプトなど）を上位アプリケーションに公開します。

🚀 クイックスタート

このplugged.in MCP Proxy Serverは、MCPクライアントに対して、複数のMCPサーバの能力を統一的に提供する役割を果たします。以下から、サーバのセットアップと起動を始めましょう。

✨ 主な機能

• 集中式能力発見（ツール、リソース、テンプレート、プロンプト）
• カスタム命令管理
• 複数ワークスペースのサポートによる異なる設定セットの維持
• 対話型コンソールによるMCPツールのテスト
• ユーザー認証とAPIキー管理

📦 インストール

1. 依存関係のインストール

Node.jsのインストール

Node.jsバージョン16以上を推奨します。以下のコマンドでインストールできます。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install --lts

npmパッケージのインストール

npm install -g npm@latest

プロジェクト依存関係のインストール

プロジェクトディレクトリに移動した後、以下のコマンドを実行します。

npm install

2. サーバの起動

以下のコマンドでプロキシサーバを起動します。

node index.js

開発サーバの起動

npm run dev

プロジェクトのビルド

npm run build

テストの実行

npm test

📚 ドキュメント

システムアーキテクチャ

このプロキシサーバは、MCPクライアント（Claude Desktopなど）と複数の基盤MCPサーバの間の橋渡しの役割を果たします。

ワークフロー

1. 設定の取得：プロキシサーバはplugged.inアプリからサーバ設定を取得します。
2. 能力リスト：
   • tools/list：/api/toolsインターフェースを通じてツールリスト（接頭辞付き）を取得します。
   • resources/list：/api/resourcesインターフェースを通じてリソースリストを取得します。
   • resource-templates/list：/api/resource-templatesインターフェースを通じてリソーステンプレートリストを取得します。
   • prompts/list：/api/promptsと/api/custom-instructionsからの結果を統合し、プロンプトリストを返します。
3. 能力解析：
   • tools/call：ツール名から接頭辞を抽出し、ターゲットサーバを検索します。
   • resources/read：/api/resolve/resource?uri=...インターフェースを呼び出してサーバの詳細情報を取得します。
   • prompts/get：カスタム命令の接頭辞があるかどうかを確認するか、/api/resolve/prompt?name=...インターフェースを呼び出します。
4. リクエストルーティング：リクエストを対応する基盤MCPサーバに転送します。
5. レスポンス処理：基盤サーバからのレスポンスをクライアントに返します。

plugged.inアプリとの統合

このプロキシサーバは、plugged.inアプリとシームレスに連携するように設計されています。

プロジェクト構造

• index.js：メインエントリーファイルで、プロキシサーバを起動します。
• config/：設定ファイルと環境変数の設定を含みます。
• routes/：さまざまなHTTPルートの処理ロジックを定義します。
• middleware/：リクエスト処理のミドルウェア機能を実装します。
• utils/：補助関数やツールメソッドを提供します。

貢献ガイド

1. リポジトリのクローン

   git clone https://github.com/yourusername/pluggedin-mcp-proxy.git
   cd pluggedin-mcp-proxy
   

2. 依存関係のインストール

   npm install
   

3. 開発環境の起動

   npm run dev
   

4. コーディングの開始

   • プロジェクト構造を確認し、コードの組織を理解します。
   • 具体的な機能モジュールに対して開発または問題の修正を行います。

5. 変更のコミット

   • 修正が完了したら、変更を追加します。

     git add .
     git commit -m "あなたのコミットメッセージ"
     

   • リモートリポジトリにプッシュします。

     git push origin your-branch-name
     

6. Pull Requestの作成

   • GitHubでプロジェクトに新しいPull Requestを作成し、行った変更とその目的を詳細に説明します。

問題の報告

何か問題が発生した場合や改善提案がある場合は、IssuesページにIssueを投稿してください。

🔧 技術詳細

このプロキシサーバは、MCPクライアントと複数のMCPサーバの間で、設定の取得、能力のリスト化、解析、リクエストのルーティング、レスポンスの処理を行います。具体的なワークフローは上記の通りです。

📄 ライセンス

このプロジェクトはMIT LICENSEに基づいてライセンスされています。

関連リソース

• plugged.inアプリリポジトリ
• モデルコンテキストプロトコル（MCP）仕様
• Claude Desktopドキュメント
• Clineドキュメント