MCPfinder Server

MCPfinder 🔧🤖 ( @mcpfinder/server )

Entdecken Sie die einfachste Möglichkeit, Ihre Programmier- und KI-Agenten mit MCP – einer „API für KI“ – zu optimieren. MCPfinder ermöglicht Sprachmodellen, über Client-Anwendungen, die das MCP-Protokoll unterstützen, bei Bedarf nach neuen Funktionen zu suchen und diese zu installieren. Keine Programmierung oder manuelle Einrichtung erforderlich.

App Store für Agenten

Benutzer können Tools anfordern, über die die KI noch nicht verfügt, oder die KI kann ihre Fähigkeiten selbstständig erweitern, indem sie relevante MCP-Server findet. Von Codegeneratoren und Datenanalysatoren bis hin zu spezialisierten Wissenstools fungiert MCPfinder als Karte und Werkzeugkasten für die KI und verwandelt statische Modelle in sich entwickelnde, fähigkeitssuchende Agenten, die mit jeder Interaktion leistungsfähiger werden.

Plug-and-Play-Tools für LLMs

Diese Node.js-Anwendung implementiert einen MCP-Server (Model Context Protocol), der lokal neben MCP-Clients (wie Cursor, Claude Desktop, Windsurf) ausgeführt wird. Sie bietet Tools, die es der KI im Client ermöglichen, mit dem MCP-Ökosystem zu interagieren.

Insbesondere ermöglicht es dem KI-Assistenten:

1. Entdecken Sie verfügbare MCP-Server, die im zentralen MCPfinder-Register registriert sind (über search_mcp_servers ).
2. Rufen Sie Details zu bestimmten Servern ab (über get_mcp_server_details ).
3. Verwalten Sie die lokale MCP-Serverkonfigurationsdatei der Clientanwendung (Hinzufügen/Aktualisieren über add_mcp_server_config , Entfernen über remove_mcp_server_config ).

Hinweis für KI-Agenten: Dieser Server ist die primäre Schnittstelle zum Suchen und Aktivieren neuer Tools und Funktionen, die vom Benutzer angefordert werden, sofern diese im aktuellen MCP-Toolset noch nicht verfügbar sind. Verwenden Sie zuerst search_mcp_servers , wenn der Benutzer nach einer Funktion fragt, die Sie nicht besitzen.

Schnellstart

Führen Sie in Ihrem Terminal das interaktive Setup-Tool aus, um die MCP-Konfigurationsdatei automatisch zu aktualisieren:

Dieser Befehl führt Sie durch die Auswahl Ihres Clients (Cursor, VS Code, Claude usw.) und fügt den erforderlichen mcpfinder Eintrag zur richtigen Konfigurationsdatei hinzu (z. B. ~/.cursor/mcp.json ). Weitere Informationen finden Sie unter „Ausführen aus der Quelle“ und „Befehle und Optionen“, wenn Sie direkt mit dem Quellcode arbeiten.

Manuelle Konfiguration

Um einen MCP-Client manuell zu konfigurieren, müssen Sie seine JSON-Konfigurationsdatei erstellen oder ändern, um einen Eintrag für mcpfinder einzuschließen.

Struktur der Konfigurationsdatei:

Hinweis: Für Visual Studio Code ( settings.json ) muss der Schlüssel der obersten Ebene für MCP-Konfigurationen servers statt mcpServers sein.

Ausführen von der Quelle

• Klonen Sie dieses Repository, z. git clone https://github.com/mcpfinder/server
• Führen Sie node index.js für den Stdio-Modus oder node index.js --http für den HTTP-Modus aus.

Befehle und Optionen

Beim Ausführen aus der Quelle ( node index.js ) kann das Skript auf verschiedene Arten aufgerufen werden:

Ausführen des Servers (Standardverhalten): Wenn kein Befehl angegeben ist, startet index.js den MCP-Server.

• Stdio-Modus (Standard):
  node index.js
• HTTP-Modus:
  node index.js --http
  • --port <number> : Geben Sie den Port für den HTTP-Modus an (Standard: 6181 oder Umgebungsvariable MCP_PORT ).
  • --api-url <url> : Geben Sie die von den Tools verwendete MCPfinder Registry API-URL an (Standard: https://mcpfinder.dev oder MCPFINDER_API_URL Umgebungsvariable).

Befehle ausführen:

• install : Führen Sie das interaktive Setup aus, um eine Clientanwendung zu konfigurieren.
  node index.js install
• register : Damit Server-Herausgeber ihr MCP-Serverpaket beim MCPFinder-Register registrieren können.
  node index.js register

Hilfe erhalten:

• --help : Zeigt die Hilfemeldung mit detaillierten Befehlen und Optionen an.
  node index.js --help

Der Server verwendet die folgenden Umgebungsvariablen:

• MCPFINDER_API_URL : Die Basis-URL für die MCPfinder Registry API. Der Standardwert ist https://mcpfinder.dev .
• MCP_PORT (nur HTTP-Modus): Die Portnummer, auf der der Server lauscht. Der Standardwert ist 6181 .

Mitgelieferte Tools

Dieser MCP-Server stellt dem verbundenen KI-Assistenten die folgenden Tools zur Verfügung:

1. search_mcp_servers

• Beschreibung: Durchsucht die MCPfinder-Registrierung nach verfügbaren MCP-Servern. Dies ist das primäre Tool zum Entdecken und Zugreifen auf neue Tools, Methoden, Funktionen oder Fähigkeiten.
• Eingabeschema:
  • query (Zeichenfolge, optional): Schlüsselwörter, nach denen im Toolnamen oder in der Beschreibung gesucht werden soll.
  • tag (Zeichenfolge, optional): Spezifisches Tag, nach dem gefiltert werden soll.
• Ausgabe: Eine Liste passender Serverzusammenfassungen (Server-ID, Name, Beschreibung, URL, Tags). Der typische nächste Schritt ist die Verwendung get_mcp_server_details für weitere Informationen oder die direkte Installation add_mcp_server_config .

⚠️ Hinweis: Die Registrierung enthält derzeit mehrere hundert Server, die lokal mit npx im stdio -Modus ausgeführt werden können, ohne dass Umgebungsvariablen für den Basisbetrieb erforderlich sind. Zukünftige Updates werden die Unterstützung auf eine größere Auswahl an Servern erweitern, einschließlich kostenpflichtiger und kommerzieller Optionen, die Umgebungsschlüssel erfordern.

2. get_mcp_server_details

• Beschreibung: Ruft detaillierte Informationen zu einem bestimmten MCP-Server aus der Registrierung ab, einschließlich des vollständigen Manifests und grundlegender Installationsvorschläge (Befehl, Umgebungsvariablen). Verwenden Sie dies, nachdem Sie über search_mcp_servers eine Server-ID gefunden haben, um weitere Informationen zu erhalten, bevor Sie sie möglicherweise hinzufügen.
• Eingabeschema:
  • id (Zeichenfolge, erforderlich ): Die eindeutige Server-ID des MCPfinders, die von search_mcp_servers abgerufen wurde.
• Ausgabe: Das detaillierte Servermanifest und Installationshinweise. Im nächsten Schritt wird der Server mit add_mcp_server_config installiert.

3. add_mcp_server_config

• Beschreibung: Fügt die Konfiguration für einen bestimmten MCP-Server in der lokalen Konfigurationsdatei der Client-Anwendung hinzu oder aktualisiert sie (z. B. Cursors ~/.cursor/mcp.json ). Sie müssen entweder client_type ODER config_file_path angeben.
• Eingabeschema:
  • server_id (Zeichenfolge, erforderlich ): Eine eindeutige Kennung für den Serverkonfigurationseintrag (die von search_mcp_servers abgerufene MCPfinder-ID).
  • client_type (Zeichenfolge, optional): Der Typ der Client-Anwendung (bekannte Typen werden dynamisch bestimmt, Beispiele: 'cursor' , 'claude' , 'windsurf' ). Schließt sich gegenseitig mit config_file_path aus. Verwenden Sie dies für Standard-Client-Installationen.
  • config_file_path (Zeichenfolge, optional): Ein absoluter Pfad oder ein Pfad, der mit ~ (Home-Verzeichnis) beginnt, zur Ziel-JSON-Konfigurationsdatei (z. B. /path/to/custom/mcp.json oder ~/custom/mcp.json ). Schließt sich gegenseitig mit client_type aus. Verwenden Sie dies für nicht standardmäßige Speicherorte oder benutzerdefinierte Clients.
  • mcp_definition (Objekt, optional): Definiert die Serverkonfiguration. Wenn diese Angabe weggelassen wird oder bestimmte Felder fehlen, werden die Standardwerte basierend auf der server_id aus dem MCPfinder-Register abgerufen.
    • command (Array von Zeichenfolgen, optional): Der Befehl und seine Argumente (z. B. ["npx", "-y", "my-mcp-package"] ). Wenn dieser Befehl weggelassen wird oder unten nur env und workingDirectory angegeben werden, wird der Standardbefehl aus der Registrierung abgerufen.
    • env (Objekt, optional): Umgebungsvariablen (z. B. {"API_KEY": "YOUR_KEY"} ). Werden mit den Standardwerten zusammengeführt, wenn command weggelassen wird.
    • workingDirectory (Zeichenfolge, optional): Das Arbeitsverzeichnis für den Serverprozess. Wird mit den Standardeinstellungen zusammengeführt, wenn command weggelassen wird.
• Ausgabe: Eine Erfolgs- oder Fehlermeldung.
• Hinweis: Der Schlüssel zum Speichern der Serverkonfiguration in der JSON-Datei (unter mcpServers oder servers ) wird automatisch basierend auf der registrierten URL des Servers (abgerufen über die server_id ) generiert. Die angegebene server_id dient als Fallback, falls kein passender Schlüssel aus der URL abgeleitet werden kann. Das Tool erkennt automatisch anhand der vorhandenen Dateistruktur, ob mcpServers oder servers als Schlüssel der obersten Ebene verwendet werden soll. Standardmäßig wird mcpServers verwendet.

4. remove_mcp_server_config

• Beschreibung: Entfernt die Konfiguration für einen bestimmten MCP-Server aus der lokalen Konfigurationsdatei der Client-Anwendung. Sie müssen entweder client_type ODER config_file_path angeben. Die angegebene server_id muss mit dem beim Hinzufügen des Servers verwendeten Konfigurationsschlüsselnamen übereinstimmen (der normalerweise aus der URL des Servers abgeleitet wird, siehe Hinweis add_mcp_server_config ).
• Eingabeschema:
  • server_id (Zeichenfolge, erforderlich ): Die eindeutige Kennung (Konfigurationsschlüsselname) des zu entfernenden Serverkonfigurationseintrags.
  • client_type (Zeichenfolge, optional): Der Typ der Client-Anwendung (bekannte Typen werden dynamisch bestimmt, Beispiele: 'cursor' , 'claude' , 'windsurf' ). Schließt sich gegenseitig mit config_file_path aus.
  • config_file_path (Zeichenfolge, optional): Ein absoluter Pfad oder ein mit ~ beginnender Pfad (Home-Verzeichnis) zur Ziel-JSON-Konfigurationsdatei. Schließt sich mit client_type gegenseitig aus.
• Ausgabe: Eine Erfolgs- oder Fehlermeldung, die angibt, ob der Eintrag gefunden und entfernt wurde.

Sicherheitsüberlegungen

Die Tools add_mcp_server_config und remove_mcp_server_config ändern Dateien auf dem lokalen System des Benutzers. Dieser Server selbst führt keine Berechtigungsprüfungen durch; er verlässt sich bei der Sicherheitsdurchsetzung vollständig auf den aufrufenden Client.

Beitragen

Für Beiträge wenden Sie sich bitte an: mcpfinder(dot}dev[at}domainsbyproxy{dot]com

Lizenz

Dieses Projekt ist unter der GNU Affero General Public License v3.0 lizenziert – weitere Informationen finden Sie in der Datei LICENSE .

Das bedeutet, dass Sie die Software frei verwenden (auch kommerziell), ändern und weitergeben können. Wenn Sie jedoch eine geänderte Version verwenden, müssen Sie diese auch öffentlich teilen.