MCP Advisor

Integrations

  • Provides access to MCP servers listed in the Model Context Protocol GitHub repository, allowing AI assistants to discover available services

  • Uses Mermaid for rendering architecture and data flow diagrams to visualize the MCP Advisor system architecture

  • Incorporates Shields.io badges in the README to display MCP status and links to MCP servers

MCPアドバイザー

MCPアドバイザーとインストール

MCPアドバイザーを体験

これは何ですか?

MCPアドバイザーは、モデルコンテキストプロトコル(MCP)サーバーの探索を支援する検出・推奨サービスです。AIアシスタントが自然言語クエリに基づいて利用可能なMCPサービスを発見・理解するのを支援するスマートガイドとして機能し、特定のタスクに適したツールの発見と活用を容易にします。

特徴

  • スマート検索:自然言語クエリを使用してMCPサービスを検索
  • 豊富なメタデータ:各サービスに関する詳細な情報を取得
  • リアルタイム更新:最新のMCPサービスを常に最新の状態に保ちます
  • 簡単な統合:MCP 対応の AI アシスタントと簡単に統合できます
  • ベクター検索:OceanBaseによる高性能セマンティック検索
  • モジュラーアーキテクチャ:保守性と拡張性に関する懸念を明確に分離

建築

データフロー

クイックスタート

使用法

  1. リポジトリをクローンする

または

  1. npxを使用する

インストール

Claude Desktop の場合は、 claude_desktop_config.jsonファイルを編集します。

macOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
ウィンドウズ
code $env:AppData\Claude\claude_desktop_config.json

交通手段

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

1. 標準入出力トランスポート(デフォルト)

コマンドライン ツールと直接統合にこれを使用します。

サービス検出機能を有効にするには、AI アシスタントの MCP 構成に追加します。

{ "mcpServers": { "mcp-advisor": { "command": "npx", "args": [ "-y", "/path/to/repo/build/index.js" ] } } }
2. SSEトランスポート(HTTPサーバー)

リモートサーバーやWebベースの統合に使用します。次のコマンドでサーバーを起動します。

# Start with SSE transport on port 3000 TRANSPORT_TYPE=sse SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js

SSE 構成の環境変数:

  • TRANSPORT_TYPE : SSEトランスポートを使用するにはsseに設定します(デフォルトはstdio)
  • SERVER_PORT : HTTPサーバーポート(デフォルト: 3000)
  • SERVER_HOST : HTTPサーバーホスト(デフォルト: localhost)
  • SSE_PATH : SSEエンドポイントパス(デフォルト: /sse)
  • MESSAGE_PATH : メッセージエンドポイントパス(デフォルト: /messages)

次を使用してサーバーに接続します。

  • SSEエンドポイント: http://localhost:3000/sse
  • メッセージエンドポイント: http://localhost:3000/messages?sessionId=<SESSION_ID>
  • ヘルスチェック: http://localhost:3000/health
3. RESTトランスポート
TRANSPORT_TYPE=rest SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js

クエリの例

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

"Find an MCP server for natural language processing" "MCP server for financial data analysis" "Recommendation engine MCP server for e-commerce" "MCP server with image recognition capabilities" "Weather data processing MCP server" "Document summarization MCP server"

回答例

[ { "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 multilingual support.", "github_url": "https://github.com/example/text-processor", "similarity": 0.85 } ]

トラブルシューティング

よくある問題

  1. 接続拒否
    • 指定されたポートでサーバーが実行中であることを確認する
    • ファイアウォールの設定を確認する
    • ホストアドレスが正しいことを確認する
  2. 結果が返されませんでした
    • より一般的なクエリを試してください
    • レジストリAPIへのネットワーク接続を確認する
    • APIエンドポイントが正しく設定されていることを確認する
  3. SSE接続の切断
    • クライアントのタイムアウト設定を増やす
    • サーバーログでエラーメッセージを確認する
    • ブラウザから接続する場合は、適切な CORS 構成を確認してください。
  4. パフォーマンスの問題
    • より具体的な検索語句を追加することを検討してください
    • サーバーのリソース(CPU/メモリ)を確認する
    • 同様のクエリを頻繁に行う場合はキャッシュを実装する

ログ

詳細なトラブルシューティングについては、 logsディレクトリ内のログを確認してください。以下のコマンドでデバッグログを有効にしてください。

DEBUG=true node build/index.js

環境変数

MCP Advisor は、次の環境変数を使用して構成できます。

変数説明デフォルト必須
TRANSPORT_TYPEトランスポート方法 ( stdiosserest )stdioいいえ
SERVER_PORTSSE/REST トランスポートの HTTP サーバー ポート3000いいえ
SERVER_HOSTSSE/REST トランスポート用の HTTP サーバー ホストlocalhostいいえ
SSE_PATHSSEエンドポイントパス/sseいいえ
MESSAGE_PATHメッセージエンドポイントパス/messagesいいえ
ENDPOINTRESTエンドポイントパス/restいいえ
DEBUGデバッグログを有効にするfalseいいえ
ENABLE_FILE_LOGGINGファイルへのログ記録を有効にするfalseいいえ
LOG_LEVELログレベル(デバッグ、情報、警告、エラー)infoいいえ

APIドキュメント

REST APIエンドポイント

GET /health

ヘルスチェックのエンドポイント。

応答:

{ "status": "ok", "version": "1.0.0" }
GET /sse

接続を確立するための Server-Sent Events エンドポイント。

クエリパラメータ:

  • なし

応答:

  • SSE接続を確立する
POST /messages

確立された SSE 接続にメッセージを送信するためのエンドポイント。

クエリパラメータ:

  • sessionId (文字列、必須): SSE接続のセッションID

リクエスト本文:

{ "jsonrpc": "2.0", "method": "callTool", "params": { "name": "recommend-mcp-servers", "arguments": { "query": "financial data analysis" } }, "id": "1" }

応答:

{ "jsonrpc": "2.0", "result": { "content": [ { "title": "Financial Analytics MCP", "description": "Comprehensive financial data analysis toolkit", "github_url": "https://github.com/example/financial-mcp", "similarity": 0.95 } ] }, "id": "1" }
POST /rest

直接リクエスト用の REST API エンドポイント (REST トランスポートを使用する場合)。

リクエスト本文:

{ "jsonrpc": "2.0", "method": "callTool", "params": { "name": "recommend-mcp-servers", "arguments": { "query": "financial data analysis" } }, "id": "1" }

応答: /messagesエンドポイントと同じです。

テスト

検査官

npx @modelcontextprotocol/inspector

ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。

You must be authenticated.

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  1. MCPアドバイザーとインストール
    1. MCPアドバイザーを体験
  2. これは何ですか?
    1. 特徴
      1. 建築
        1. データフロー
      2. クイックスタート
        1. 使用法
        2. インストール
        3. 交通手段
        1. クエリの例
        2. 回答例
      3. トラブルシューティング
        1. よくある問題
        2. ログ
      4. 環境変数
        1. APIドキュメント
          1. REST APIエンドポイント
        2. テスト
          1. ライセンス

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
              Last updated -
              40
              203
              TypeScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
              Last updated -
              9
              Python
              MIT License
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI agents to query Erick Wendel's talks, blog posts, and videos across different platforms using natural language.
              Last updated -
              55
              TypeScript
              MIT License
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
              Last updated -
              85
              2
              TypeScript

            View all related MCP servers

            ID: lzlc6tbjx6