Skip to main content
Glama
deenesjakoruzh

MCP Advisor

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

MCP-Berater

Englisch |简体中文

Einführung

MCP Advisor ist ein Erkennungs- und Empfehlungsdienst, der KI-Assistenten dabei unterstützt, Model Context Protocol (MCP)-Server mithilfe natürlicher Sprachabfragen zu erkunden. Er erleichtert Benutzern die Suche und Nutzung geeigneter MCP-Tools für bestimmte Aufgaben.

Merkmale

  • Suche in natürlicher Sprache : Finden Sie MCP-Dienste mithilfe von Konversationsabfragen
  • Umfangreiche Metadaten : Erhalten Sie detaillierte Informationen zu jedem Dienst
  • Echtzeit-Updates : Immer synchron mit den neuesten MCP-Diensten
  • Einfache Integration : Einfache Konfiguration für jeden MCP-kompatiblen KI-Assistenten
  • Hybrid-Suchmaschine : Erweiterte Suchfunktionen, die Vektorsuche und Textabgleich kombinieren
  • Unterstützung mehrerer Anbieter : Unterstützung für die parallele Ausführung mehrerer Suchanbieter

Dokumentationsnavigation

Schnellstart

Installation

Der schnellste Weg ist die Integration von MCP Advisor über die MCP-Konfiguration:

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

Fügen Sie diese Konfiguration zur MCP-Einstellungsdatei Ihres KI-Assistenten hinzu:

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

Weitere Installationsmethoden finden Sie im Installationshandbuch .

Demo

Entwicklerhandbuch

Architekturübersicht

MCP Advisor verwendet eine modulare Architektur mit klarer Trennung der Belange und funktionalen Programmierprinzipien:

Kernkomponenten

  1. Suchdienstebene
    • Einheitliche Suchoberfläche und Anbieteraggregation
    • Unterstützung für mehrere parallel ausgeführte Suchanbieter
    • Konfigurierbare Suchoptionen (Limit, minSimilarity)
  2. Anbieter suchen
    • Meilisearch-Anbieter : Vektorsuche mit Meilisearch
    • GetMCP-Anbieter : API-Suche aus der GetMCP-Registrierung
    • Compass Provider : API-Suche aus dem Compass-Register
    • Offline-Anbieter : Hybridsuche, die Text und Vektoren kombiniert
  3. Hybride Suchstrategie
    • Intelligente Kombination aus Textvergleich und Vektorsuche
    • Konfigurierbarer Gewichtsausgleich
    • Intelligente adaptive Filtermechanismen
  4. Transportschicht
    • Stdio (CLI-Standard)
    • SSE (Web-Integration)
    • REST-API-Endpunkte

Eine ausführlichere Architekturdokumentation finden Sie unter ARCHITECTURE.md .

Technische Highlights

Erweiterte Suchtechniken

  1. Vektornormalisierung
    • Alle Vektoren sind auf die Einheitslänge normalisiert (Betrag = 1)
    • Gewährleistet konsistente Kosinus-Ähnlichkeitsberechnungen
    • Verbessert die Suchpräzision durch Fokussierung auf die Richtung statt auf die Größe
  2. Parallele Suchausführung
    • Vektorsuche und Textsuche laufen parallel
    • Nutzt Promise.all für optimale Leistung
    • Fallback-Mechanismen aktiviert, wenn eine der Suchen fehlschlägt
  3. Zusammenführen gewichteter Ergebnisse
    • Konfigurierbare Gewichte zwischen Vektor- und Textergebnissen
    • Standard: Vektorähnlichkeit (70 %), Textübereinstimmung (30 %)

Fehlerbehandlungs- und Protokollierungssystem

MCP Advisor implementiert robuste Fehlerbehandlungs- und Protokollierungssysteme:

  1. Kontextbezogene Fehlerformatierung
    • Standardisierte Fehlerobjektanreicherung
    • Beibehaltung und Formatierung des Stacktrace
    • Fehlertypkategorisierung und -standardisierung
  2. Anmutige Degradierung
    • Multi-Provider-Fallback-Strategien
    • Teilergebnisverarbeitung
    • Standardreaktionen bei kritischen Fehlern

Weitere technische Einzelheiten finden Sie unter TECHNICAL_DETAILS.md .

Schnellstart für Entwickler

Einrichten der Entwicklungsumgebung

  1. Klonen Sie das Repository
  2. Installieren Sie Abhängigkeiten:
    npm install
  3. Konfigurieren Sie Umgebungsvariablen (siehe INSTALLATION.md )

Bibliotheksnutzung

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);

Transportmöglichkeiten

MCP Advisor unterstützt mehrere Transportmethoden:

  1. Stdio Transport (Standard) – Geeignet für Befehlszeilentools
  2. SSE Transport – Geeignet für die Webintegration
  3. REST-Transport – Bietet REST-API-Endpunkte

Weitere Entwicklungsdetails finden Sie unter DEVELOPER_GUIDE.md .

Beitragsrichtlinien

  1. Befolgen Sie die Konventionen für Commit-Nachrichten:
    • Verwenden Sie Kleinbuchstaben (feat, fix, docs usw.).
    • Schreiben Sie beschreibende Nachrichten im Satzformat
  2. Sicherstellen der Codequalität:
    • Tests ausführen: npm test
    • Typen prüfen: npm run type-check
    • Lint-Code: npm run lint

Ausführliche Richtlinien für Beiträge finden Sie unter CONTRIBUTING.md .

Anwendungsbeispiele

Beispielabfragen

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

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

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

Weitere Beispiele finden Sie unter EXAMPLES.md .

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
  2. Keine Ergebnisse zurückgegeben
    • Versuchen Sie eine allgemeinere Abfrage
    • Überprüfen Sie die Netzwerkverbindung zu den Registrierungs-APIs
  3. Leistungsprobleme
    • Erwägen Sie das Hinzufügen spezifischerer Suchbegriffe
    • Serverressourcen (CPU/Speicher) prüfen

Weitere Informationen zur Fehlerbehebung finden Sie unter TROUBLESHOOTING.md .

Anbieter suchen

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

  1. Compass Search Provider : Ruft MCP-Serverinformationen mithilfe der Compass-API ab
  2. GetMCP-Suchanbieter : Verwendet die GetMCP-API und die Vektorsuche für die semantische Übereinstimmung
  3. Meilisearch-Suchanbieter : Verwendet Meilisearch für eine schnelle, fehlertolerante Textsuche

Ausführliche Informationen zu Suchanbietern finden Sie unter SEARCH_PROVIDERS.md .

API-Dokumentation

Eine ausführliche API-Dokumentation finden Sie unter API_REFERENCE.md .

Fahrplan

MCP Advisor entwickelt sich von einem einfachen Empfehlungssystem zu einer intelligenten Agenten-Orchestrierungsplattform. Unsere Vision ist ein System, das nicht nur die richtigen MCP-Server empfiehlt, sondern auch aus Interaktionen lernt und Agenten bei der dynamischen Planung und Ausführung komplexer Aufgaben unterstützt.

Wichtige Entwicklungsphasen

  1. Optimierung der Empfehlungsfähigkeit (2025 Q2-Q3)
    • Akzeptieren Sie Benutzerfeedback
    • Verfeinern Sie die Wirksamkeit von Empfehlungen
    • Einführung weiterer Indizes

Eine detaillierte Roadmap finden Sie unter ROADMAP.md .

Testen

Verwenden Sie den Inspector zum Testen:

npx @modelcontextprotocol/inspector

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei 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.

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

  1. Einführung
    1. Merkmale
      1. Dokumentationsnavigation
        1. Schnellstart
          1. Installation
          2. Demo
        2. Entwicklerhandbuch
          1. Architekturübersicht
          2. Kernkomponenten
        3. Technische Highlights
          1. Erweiterte Suchtechniken
          2. Fehlerbehandlungs- und Protokollierungssystem
        4. Schnellstart für Entwickler
          1. Einrichten der Entwicklungsumgebung
          2. Bibliotheksnutzung
          3. Transportmöglichkeiten
        5. Beitragsrichtlinien
          1. Anwendungsbeispiele
            1. Beispielabfragen
            2. Beispielantwort
          2. Fehlerbehebung
            1. Häufige Probleme
          3. Anbieter suchen
            1. API-Dokumentation
              1. Fahrplan
                1. Wichtige Entwicklungsphasen
              2. Testen
                1. Lizenz

                  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