MCP Advisor

MCP Advisor

English | 简体中文

MCP Advisor は、MCP クライアントがタスクに適したサーバーを見つけ、インストール手順を確認できるようにします。検索プロバイダーを集約して推奨候補を返しますが、サーバーのインストール、クライアント設定の編集、推奨サーバーの安全性の確認は行いません。

まずはこちら

1. 現在のソースを使用する場合： MCP 2026-07-28 クライアント、stdio、または HTTP については、クイックスタートに従ってください。
2. 古いクライアントが必要な場合： 公開されている npm バージョン 1.0.5 は、独立したレガシーリリースです。現在のソース向けのトランスポート設定を適用しないでください。
3. 開発または問題の診断を行う場合： コントリビューション、アーキテクチャ、技術リファレンスをお読みください。現在のプロトコルに関する問題は、移行ガイドから確認してください。

受賞歴とプロジェクトの背景

MCP Advisor は mcpadvisor チームが開発しています。同チームは、2025 年に開催された第 1 回 OceanBase AI Hackathon（首届 OceanBase AI 黑客松大赛）で 2 位を受賞しました。 主催者による 5 月 19 日のイベントレポートでは、チーム名と MCP の検索・推奨プロジェクトが紹介されています。イベントは 2025 年 5 月 17 日に広州で終了しました。 作者による OceanBase コミュニティの投稿では、このプロジェクトとこのリポジトリとの関連が示されています。これは過去の受賞歴であり、現在のすべての機能に対するベンチマークや推奨を意味するものではありません。

利用できる機能

機能	現在のソースでの状況
recommend-mcp-servers	タスクに基づく推奨。キーワードや機能を任意で指定できます
install-mcp-server	インストール手順や設定テキストのみを提供。自動インストールは行いません
Meilisearch、Compass、GetMCP	CLI が構成します。外部サービスの利用可否や設定も必要です
オフラインプロバイダー	SearchService でデフォルト有効です。埋め込みにはモデルのダウンロードが必要な場合があります
Nacos ディスカバリー	オプトイン方式です。CLI ではアドレス、ユーザー名およびパスワードが必要です
Cline Marketplace	実装済み。CLINE_MARKETPLACE_ENABLED=true でオプトインできます
FlashRank による再ランキング	実装済み、デフォルトでは無効です。Python サービスとモデルを別途起動する必要があります
検索品質の評価	評価ツールと参考用フィクスチャを提供します。本番品質を証明するものではありません
自動インストール／品質保証	未実装／確立されていません

有効な Meilisearch プロバイダーでは、テキスト検索を使用します。オフライン検索ではテキストとベクトルを組み合わせます。これは、あらゆる状況でのベクトル検索、適応型のクエリ重み付け、または 5 件の結果が保証されることを意味しません。オンラインプロバイダーはオフラインデータと並行して引き続き動作します。

実行環境を選択する

現在のソース（最新プロトコル）

アプリケーションには Node.js 20 以降を使用してください。Inspector 2.10.1 には Node.js 22.19 以降も必要です。package.json で指定されている pnpm 8.15.9 を使用してください。

git clone https://github.com/istarwyh/mcpadvisor.git
cd mcpadvisor
corepack enable
pnpm install --frozen-lockfile
pnpm run build
node build/index.js

デフォルトは stdio です。診断情報を stdout に出力しないでください。ローカル HTTP を使用する場合：

TRANSPORT_TYPE=http SERVER_HOST=127.0.0.1 SERVER_PORT=3000 node build/index.js

互換性のある MCP 2026-07-28 クライアントを http://127.0.0.1:3000/mcp に接続してください。公式 SDK のクライアント例を参照してください。 HTTP はステートレスで、リクエストごとに新しいプロトコルサーバーが作成されます。プロバイダーのキャッシュはプロセス単位で維持される場合があります。古い SSE／REST モードは拒否され、古い HTTP パスは 410 を返します。最新の POST レスポンスでも SSE エンコードが使用されることがあります。組み込みの認証機能や、ブラウザーのクロスオリジン CORS 機能はありません。独立して保護されたゲートウェイを用意しない場合は、ループバックへのバインドを維持してください。ホスティングの受け入れを意味するものではありません。

公開済み npm 1.0.5（レガシー）

npx -y @xiaohui-wang/[email protected]

これは上記のソースではなく、以前に公開された成果物を選択します。クライアントとの互換性と設定は、成果物ごとに確認してください。ソースのチェックアウトでバージョン 1.0.5 が宣言されていても、そのソースの変更が npm に公開されているとは限りません。

サードパーティー製インストーラー

マーケットプレイス／Smithery の掲載内容とインストーラーは、それぞれ独立して保守されています。 実行する前に、選択した成果物／バージョン、権限、トランスポートを確認してください。 このガイドは、それらが現在の最新ソースを提供することを保証するものではありません。

設定と拡張

CLI は SEARCH_PROVIDER、SEARCH_LIMIT、SEARCH_MIN_SIMILARITY を読み込みません。 プロバイダーの注入と SearchOptions は、プログラムから利用する SearchService API の機能であり、 存在しない環境変数フラグを作るものではありません。 npm のルートから SearchService をインポートしないでください。このパッケージのエントリーポイントは、 起動時に副作用のある CLI です。ソースチェックアウトの API 例を参照してください。

トピック	ガイド
CLI、HTTP、Nacos の認証情報、プログラムから指定するオプション	クイックスタート
ローカル Meilisearch のライフサイクル	ローカル Meilisearch
テキスト検索の動作	全文検索
オプションの Cline ソース	Cline マーケットプレイス
オプションのローカルモデルサービス、障害時のフォールバック、プライバシー	FlashRank
評価データ、指標、例示データの制限	検索品質の評価
Inspector の前提条件と対象を絞ったブラウザーチェック	Inspector UI テスト
最新プロトコルとロールバックの範囲	MCP の移行
以前の運用診断	トラブルシューティング

ホスティング関連の改訂は、トラブルシューティングとは別に PR #40 で追跡されています。現在のトランスポートの動作については、 移行ガイドを参照してください。マージされていないホスティング設定は、これらの手順には含まれていません。

変更を検証する

pnpm run check
pnpm test
pnpm run build
pnpm run test:protocol

これらは、それぞれ lint／フォーマット、Vitest、本番用コンパイル、対象を絞ったオフラインの プロトコル／起動チェックを実行します。ライブのプロバイダーが利用可能であることや、 ランキングの品質を証明するものではありません。Playwright の一括スイートは pnpm run test:e2e （scripts/e2e/e2e.run.sh）です。実行には、ドキュメントに記載されたブラウザー／サービスの前提条件が必要です。 選択した Inspector の spec は、一括スイートではありません。コントリビューションと Inspector UI テストを参照してください。

プロジェクトの方針とドキュメント

ロードマップには過去の計画が記載されており、現在の提供予定日は示されていません。 Cline と FlashRank は実装済みのオプション機能であり、未着手の実装 TODO ではありません。 新たなプロバイダー連携、品質に関する主張、デプロイ作業には、それぞれ独自の範囲設定と根拠が必要です。

ドキュメントレビュー記録には、ソースの基準、 検証の範囲、言語版の方針が記載されています。 イシューを作成し、対象を絞ってテスト済みのプルリクエストを送っていただくことで、貢献できます。