Skip to main content
Glama
Sign In
deenesjakoruzh

MCP Advisor

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

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-Berater

MCP-Berater und Installation

NPM-Installation

Sie können MCP Advisor direkt von npm installieren:

# Using npm npm install @xiaohui-wang/mcpadvisor # Using yarn yarn add @xiaohui-wang/mcpadvisor # Using pnpm pnpm add @xiaohui-wang/mcpadvisor

Verwendung

Als Befehlszeilentool
# Run directly with npx npx @xiaohui-wang/mcpadvisor # Or if installed globally mcpadvisor
Als Bibliothek
import { SearchService } from '@xiaohui-wang/mcpadvisor'; // Initialize the search service const searchService = new SearchService(); // Search for MCP servers const results = await searchService.search('vector database integration'); console.log(results);

MCP-Berater erleben

Was ist das?

MCP Advisor ist ein Such- und Empfehlungsdienst, der Sie bei der Erkundung von Model Context Protocol-Servern unterstützt. Er fungiert als intelligenter Leitfaden, der KI-Assistenten hilft, verfügbare MCP-Dienste anhand von Abfragen in natürlicher Sprache zu finden und zu verstehen. So können Sie leichter die richtigen Tools für bestimmte Aufgaben finden und nutzen.

Merkmale

  • Intelligente Suche : Finden Sie MCP-Dienste mithilfe von Abfragen in natürlicher Sprache
  • Umfangreiche Metadaten : Erhalten Sie detaillierte Informationen zu jedem Dienst
  • Echtzeit-Updates : Immer auf dem neuesten Stand mit den neuesten MCP-Diensten
  • Einfache Integration : Einfache Integration mit jedem MCP-kompatiblen KI-Assistenten
  • Mehrere Such-Backends :
    • OceanBase : Leistungsstarke Vektordatenbank für die semantische Suche
    • Meilisearch : Schnelle, leichte Suchmaschine mit Tippfehlertoleranz
  • Modulare Architektur : Saubere Trennung der Belange der Wartbarkeit und Erweiterbarkeit

Architektur

Datenfluss

Schnellstart

Verwendung

  1. Klonen Sie das Repository

oder

  1. Verwenden Sie npx

Installation

Bearbeiten Sie für Claude Desktop Ihre Datei claude_desktop_config.json :

MacOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows
code $env:AppData\Claude\claude_desktop_config.json

Transportmöglichkeiten

MCP Advisor unterstützt zwei Transportmethoden:

1. Stdio-Transport (Standard)

Verwenden Sie dies für Befehlszeilentools und direkte Integrationen.

Fügen Sie der MCP-Konfiguration Ihres KI-Assistenten Folgendes hinzu, um die Serviceerkennungsfunktionen zu aktivieren:

{ "mcpServers": { "mcp-advisor": { "command": "npx", "args": [ "-y", "/path/to/repo/build/index.js" ] } } }
2. SSE-Transport (HTTP-Server)

Verwenden Sie dies für Remote-Server oder webbasierte Integrationen. Starten Sie den Server mit:

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

Umgebungsvariablen für die SSE-Konfiguration:

  • TRANSPORT_TYPE : Auf sse setzen, um SSE-Transport zu verwenden (Standard ist stdio)
  • SERVER_PORT : HTTP-Server-Port (Standard: 3000)
  • SERVER_HOST : HTTP-Server-Host (Standard: localhost)
  • SSE_PATH : SSE-Endpunktpfad (Standard: /sse)
  • MESSAGE_PATH : Nachrichtenendpunktpfad (Standard: /messages)

Stellen Sie eine Verbindung zum Server her, indem Sie Folgendes verwenden:

  • SSE-Endpunkt: http://localhost:3000/sse
  • Nachrichtenendpunkt: http://localhost:3000/messages?sessionId=<SESSION_ID>
  • Gesundheitscheck: http://localhost:3000/health
3. REST-Transport
TRANSPORT_TYPE=rest SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js

Beispiele

Beispielabfragen

Hier sind einige Beispielabfragen, die Sie mit MCP Advisor verwenden können:

"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"

Beispielantwort

[ { "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 } ]

Fehlerbehebung

Häufige Probleme

  1. Verbindung abgelehnt
    • Stellen Sie sicher, dass der Server auf dem angegebenen Port läuft
    • Überprüfen Sie die Firewall-Einstellungen
    • Überprüfen Sie, ob die Hostadresse korrekt ist
  2. Keine Ergebnisse zurückgegeben
    • Versuchen Sie eine allgemeinere Abfrage
    • Überprüfen Sie die Netzwerkkonnektivität zur Registrierungs-API
    • Überprüfen Sie, ob die API-Endpunkte korrekt konfiguriert sind
  3. SSE-Verbindungsabbrüche
    • Erhöhen Sie die Client-Timeout-Einstellungen
    • Überprüfen Sie die Serverprotokolle auf Fehlermeldungen
    • Stellen Sie bei einer Verbindung über einen Browser die richtige CORS-Konfiguration sicher
  4. Leistungsprobleme
    • Erwägen Sie das Hinzufügen spezifischerer Suchbegriffe
    • Serverressourcen (CPU/Speicher) prüfen
    • Implementieren Sie Caching, wenn Sie häufig ähnliche Abfragen durchführen

Protokolle

Eine detaillierte Fehlerbehebung finden Sie in den Protokollen im logs . Aktivieren Sie die Debug-Protokollierung mit:

DEBUG=true node build/index.js

Umgebungsvariablen

MCP Advisor kann mit den folgenden Umgebungsvariablen konfiguriert werden:

VariableBeschreibungStandardErforderlich
TRANSPORT_TYPETransportmethode ( stdio , sse , rest )stdioNEIN
SERVER_PORTHTTP-Server-Port für SSE/REST-Transport3000NEIN
SERVER_HOSTHTTP-Server-Host für SSE/REST-TransportlocalhostNEIN
SSE_PATHSSE-Endpunktpfad/sseNEIN
MESSAGE_PATHNachrichtenendpunktpfad/messagesNEIN
ENDPOINTREST-Endpunktpfad/restNEIN
DEBUGAktivieren der DebugprotokollierungfalseNEIN
ENABLE_FILE_LOGGINGProtokollierung in Dateien aktivierenfalseNEIN
LOG_LEVELProtokollebene (Debug, Info, Warnung, Fehler)infoNEIN
ENABLE_MEILISEARCH_TESTSMeilisearch-Tests aktivierenfalseNEIN
VECTOR_ENGINE_TYPEVektor-Engine-Typ ( memory , oceanbase , meilisearch )memoryNEIN

Anbieter suchen

MCP Advisor unterstützt mehrere Suchanbieter, die gleichzeitig verwendet werden können:

1. Kompasssuchanbieter

Verwendet die Compass-API, um MCP-Serverinformationen abzurufen.

2. GetMCP-Suchanbieter

Verwendet die GetMCP-API und die Vektorsuche für die semantische Übereinstimmung.

3. Meilisearch Suchanbieter

Verwendet Meilisearch für eine schnelle, Tippfehler-tolerante Textsuche.

Meilisearch-Konfiguration

Die Meilisearch-Integration kann in src/config/meilisearch.ts konfiguriert werden:

export const MEILISEARCH_CONFIG = { host: 'https://ms-1c8c8f2b0bc7-1.lon.meilisearch.io', apiKey: '', // API key with read permissions indexName: 'mcp_server_info_from_getmcp_io' };

API-Dokumentation

REST-API-Endpunkte

GET /health

Endpunkt der Integritätsprüfung.

Antwort:

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

Server-Sent Events-Endpunkt zum Herstellen einer Verbindung.

Abfrageparameter:

  • Keiner

Antwort:

  • Stellt eine SSE-Verbindung her
POST /messages

Endpunkt zum Senden von Nachrichten an eine hergestellte SSE-Verbindung.

Abfrageparameter:

  • sessionId (Zeichenfolge, erforderlich): Die Sitzungs-ID der SSE-Verbindung

Anforderungstext:

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

Antwort:

{ "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-Endpunkt für direkte Anfragen (bei Verwendung des REST-Transports).

Anforderungstext:

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

Antwort: Dasselbe wie /messages Endpunkt.

Prüfen

mit Inspektor

npx @modelcontextprotocol/inspector

Lizenz

MIT-Lizenz – Einzelheiten finden Sie in der Datei LICENSE .

You must be authenticated.

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

hybrid server

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

Ein Erkennungs- und Empfehlungsdienst, der KI-Assistenten dabei hilft, Model Context Protocol-Server basierend auf Abfragen in natürlicher Sprache zu finden.

  1. MCP-Berater und Installation
    1. NPM-Installation
    2. Verwendung
    3. MCP-Berater erleben
  2. Was ist das?
    1. Merkmale
      1. Architektur
        1. Datenfluss
      2. Schnellstart
        1. Verwendung
        2. Installation
        3. Transportmöglichkeiten
      3. Beispiele
        1. Beispielabfragen
        2. Beispielantwort
      4. Fehlerbehebung
        1. Häufige Probleme
        2. Protokolle
      5. Umgebungsvariablen
        1. Anbieter suchen
          1. 1. Kompasssuchanbieter
          2. 2. GetMCP-Suchanbieter
          3. 3. Meilisearch Suchanbieter
        2. Meilisearch-Konfiguration
          1. API-Dokumentation
            1. REST-API-Endpunkte
          2. Prüfen
            1. Lizenz

              Related MCP Servers

              • ClickUp MCP Server

                v4lheru
                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

              • ServiceNow MCP Server

                michaelbuckner
                -
                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

              • Erick Wendel Contributions MCP

                ErickWendel
                -
                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

              • Coolify MCP Server

                StuMason
                -
                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

              New MCP Servers

              ID: lzlc6tbjx6