Skip to main content
Glama
deenesjakoruzh

MCP Advisor

by istarwyh
npmGitHub
TypeScript
MIT License
553
32
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCPアドバイザー

English |简体中文

導入

MCPアドバイザーは、AIアシスタントが自然言語クエリを使用してモデルコンテキストプロトコル（MCP）サーバーを探索するのに役立つ検出および推奨サービスです。これにより、ユーザーは特定のタスクに適したMCPツールをより簡単に見つけ、活用できるようになります。

特徴

  • 自然言語検索: 会話クエリを使用して MCP サービスを検索する
  • 豊富なメタデータ:各サービスに関する詳細な情報を取得
  • リアルタイム更新：常に最新のMCPサービスと同期
  • 簡単な統合対応のAIアシスタントを簡単に設定可能
  • ハイブリッド検索エンジン:ベクター検索とテキストマッチングを組み合わせた高度な検索機能
  • マルチプロバイダサポート: 複数の検索プロバイダの並列実行をサポート

ドキュメントナビゲーション

クイックスタート

インストール

最も速い方法は、MCP 構成を通じて MCP Advisor を統合することです。

{ "mcpServers": { "mcpadvisor": { "command": "npx", "args": ["-y", "@xiaohui-wang/mcpadvisor"] } } }

この構成を AI アシスタントの MCP 設定ファイルに追加します。

  • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %AppData%\Claude\claude_desktop_config.json

詳細なインストール方法については、インストール ガイドを参照してください。

デモ

開発者ガイド

アーキテクチャの概要

MCP Advisor は、明確な関心の分離と関数型プログラミングの原則を備えたモジュール型アーキテクチャを採用しています。

コアコンポーネント

  1. 検索サービス層
    • 統合検索インターフェースとプロバイダー集約
    • 複数の検索プロバイダの並列実行をサポート
    • 設定可能な検索オプション（制限、最小類似度）
  2. 検索プロバイダー
    • Meilisearch プロバイダ: Meilisearch を使用したベクター検索
    • GetMCP プロバイダー: GetMCP レジストリからの API 検索
    • Compass プロバイダー: Compass レジストリからの API 検索
    • オフラインプロバイダー：テキストとベクターを組み合わせたハイブリッド検索
  3. ハイブリッド検索戦略
    • テキストマッチングとベクトル検索のインテリジェントな組み合わせ
    • 設定可能な重量バランス
    • スマートな適応フィルタリングメカニズム
  4. トランスポート層
    • Stdio (CLI のデフォルト)
    • SSE（Web統合）
    • REST APIエンドポイント

より詳細なアーキテクチャドキュメントについては、 ARCHITECTURE.md を参照してください。

技術的なハイライト

高度な検索テクニック

  1. ベクトル正規化
    • すべてのベクトルは単位長さ（大きさ = 1）に正規化されます。
    • 一貫したコサイン類似度計算を保証する
    • 大きさではなく方向に焦点を当てることで検索精度が向上します
  2. 並列検索実行
    • ベクトル検索とテキスト検索は並行して実行される
    • 最適なパフォーマンスのために Promise.all を活用
    • どちらかの検索が失敗した場合にフォールバックメカニズムが有効になります
  3. 重み付け結果のマージ
    • ベクターとテキスト結果間の重みを設定可能
    • デフォルト: ベクトル類似度 (70%)、テキスト一致 (30%)

エラー処理およびログシステム

MCP Advisor は、堅牢なエラー処理およびログ記録システムを実装します。

  1. コンテキストエラーの書式設定
    • 標準化誤差オブジェクトエンリッチメント
    • スタックトレースの保存とフォーマット
    • エラーの種類の分類と標準化
  2. 優雅な劣化
    • マルチプロバイダーフォールバック戦略
    • 部分的な結果処理
    • 重大な障害に対するデフォルトの応答

技術的な詳細については、 TECHNICAL_DETAILS.md を参照してください。

開発者クイックスタート

開発環境のセットアップ

  1. リポジトリをクローンする
  2. 依存関係をインストールします:
    npm install
  3. 環境変数を設定します（ INSTALLATION.mdを参照）

図書館の利用

import { SearchService } from '@xiaohui-wang/mcpadvisor'; // Initialize search service const searchService = new SearchService(); // Search for MCP servers const results = await searchService.search('vector database integration'); console.log(results);

交通手段

MCP アドバイザーは複数のトランスポート方法をサポートしています。

  1. Stdioトランスポート（デフォルト） - コマンドラインツールに適しています
  2. SSEトランスポート- Web統合に適しています
  3. RESTトランスポート- REST APIエンドポイントを提供します

開発の詳細については、 DEVELOPER_GUIDE.md を参照してください。

寄稿ガイドライン

  1. コミット メッセージの規則に従ってください。
    • 小文字を使用します (feat、fix、docs など)
    • 説明的なメッセージを文章形式で書く
  2. コードの品質を確保する:
    • テストを実行: npm test
    • 型をチェックする: npm run type-check
    • リントコード: npm run lint

詳細な貢献ガイドラインについては、 CONTRIBUTING.md を参照してください。

使用例

クエリの例

MCP Advisor で使用できるクエリの例を次に示します。

"Find MCP servers for natural language processing" "MCP servers for financial data analysis" "E-commerce recommendation engine MCP servers" "MCP servers with image recognition capabilities" "Weather data processing MCP servers" "Document summarization MCP servers"

回答例

[ { "title": "NLP Toolkit", "description": "Comprehensive natural language processing toolkit with sentiment analysis, entity recognition, and text summarization capabilities.", "github_url": "https://github.com/example/nlp-toolkit", "similarity": 0.92 }, { "title": "Text Processor", "description": "Efficient text processing MCP server with multi-language support.", "github_url": "https://github.com/example/text-processor", "similarity": 0.85 } ]

その他の例については、 EXAMPLES.md を参照してください。

トラブルシューティング

よくある問題

  1. 接続拒否
    • 指定されたポートでサーバーが実行中であることを確認する
    • ファイアウォールの設定を確認する
  2. 結果が返されませんでした
    • より一般的なクエリを試してください
    • レジストリ API へのネットワーク接続を確認する
  3. パフォーマンスの問題
    • より具体的な検索語句を追加することを検討してください
    • サーバーのリソース（CPU/メモリ）を確認する

トラブルシューティングの詳細については、 TROUBLESHOOTING.md を参照してください。

検索プロバイダー

MCP アドバイザーは、同時に使用できる複数の検索プロバイダーをサポートしています。

  1. Compass Search Provider : Compass API を使用して MCP サーバー情報を取得します。
  2. GetMCP 検索プロバイダ: GetMCP API とベクトル検索を使用してセマンティックマッチングを行います。
  3. Meilisearch 検索プロバイダ:高速でフォールトトレラントなテキスト検索に Meilisearch を使用

検索プロバイダーの詳細については、 SEARCH_PROVIDERS.md を参照してください。

APIドキュメント

詳細な API ドキュメントについては、 API_REFERENCE.md を参照してください。

ロードマップ

MCPアドバイザーは、単純な推奨システムから、インテリジェントなエージェントオーケストレーションプラットフォームへと進化しています。私たちのビジョンは、適切なMCPサーバーを推奨するだけでなく、インタラクションから学習し、エージェントが複雑なタスクを動的に計画・実行できるよう支援するシステムを構築することです。

主要な開発フェーズ

  1. 推奨機能の最適化（2025年第2四半期～第3四半期）
    • ユーザーからのフィードバックを受け入れる
    • 推奨効果を改善する
    • より多くの指標を導入する

詳細なロードマップについては、 ROADMAP.md を参照してください。

テスト

テストにはインスペクターを使用します。

npx @modelcontextprotocol/inspector

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

AI アシスタントが自然言語クエリに基づいてモデル コンテキスト プロトコル サーバーを見つけるのに役立つ検出および推奨サービス。

  1. 導入
    1. 特徴
      1. ドキュメントナビゲーション
        1. クイックスタート
          1. インストール
          2. デモ
        2. 開発者ガイド
          1. アーキテクチャの概要
          2. コアコンポーネント
        3. 技術的なハイライト
          1. 高度な検索テクニック
          2. エラー処理およびログシステム
        4. 開発者クイックスタート
          1. 開発環境のセットアップ
          2. 図書館の利用
          3. 交通手段
        5. 寄稿ガイドライン
          1. 使用例
            1. クエリの例
            2. 回答例
          2. トラブルシューティング
            1. よくある問題
          3. 検索プロバイダー
            1. APIドキュメント
              1. ロードマップ
                1. 主要な開発フェーズ
              2. テスト
                1. ライセンス

                  Related MCP Servers

                  • WebSearch-MCP

                    mnhlt
                    A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
                    Last updated -
                    1
                    44
                    8
                    JavaScript
                    • Apple
                    • Linux

                  • MCP Web Search Tool

                    gabrimatic
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.
                    Last updated -
                    3
                    TypeScript
                    MIT License

                  • CodeAlive MCPofficial

                    CodeAlive-AI
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.
                    Last updated -
                    40
                    Python
                    MIT License
                    • Apple

                  • MCPfinder Server

                    mcpfinder
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables AI assistants to discover, retrieve details about, and manage MCP (Model Context Protocol) servers that provide additional tools and capabilities on demand.
                    Last updated -
                    4
                    209
                    3
                    JavaScript
                    AGPL 3.0
                    • Linux
                    • Apple

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/istarwyh/mcpadvisor'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server