Enables searching any Git repository, with support for specifying branches, tags, or commit hashes, and configurable automatic updates through periodic git pulls
Allows chatting with GitHub repositories by downloading or cloning them for search, supporting both public and private repositories, with options for automatic updates
Dieses Projekt bietet einen flexiblen Model Context Protocol (MCP)-Server, der von Probe betrieben wird und dafür konzipiert ist, Dokumentationen oder Codebasen für KI-Assistenten durchsuchbar zu machen.
Sie können mit Code oder Ihren Dokumenten chatten, indem Sie einfach auf ein Git-Repo oder einen Ordner zeigen.
Anwendungsfälle:
Die Inhaltsquelle (Dokumentation oder Code) kann während des npm run build Schritts vorab in das Paket integriert oder zur Laufzeit dynamisch über lokale Verzeichnisse oder Git-Repositorys konfiguriert werden. Standardmäßig lädt der Server bei Verwendung einer gitUrl ohne Aktivierung automatischer Updates ein .tar.gz Archiv für einen schnelleren Start herunter. Vollständiges Git-Klonen wird nur verwendet, wenn autoUpdateInterval größer als 0 ist.
Die primäre Möglichkeit, diesen Server zu nutzen, ist über npx . Dadurch wird das Paket heruntergeladen und ausgeführt, ohne dass eine lokale Installation erforderlich ist. Dies erleichtert die Integration mit KI-Assistenten und MCP-Clients (wie IDE-Erweiterungen).
So installieren Sie Docs MCP Server für Claude Desktop automatisch über Smithery :
Sie können Ihren MCP-Client so konfigurieren, dass dieser Server mit npx gestartet wird. Hier sind Beispiele für die Konfiguration eines Clients (die Syntax kann je nach Client variieren):
Beispiel 1: Dynamisches Durchsuchen eines Git-Repositorys (Tyk Docs)
Diese Konfiguration weist den Client an, das neueste @buger/docs-mcp -Paket mit npx auszuführen und es dynamisch auf das Tyk-Dokumentationsrepository zu verweisen. Das Argument -y bestätigt automatisch die npx Installationsaufforderung. Die Argumente --toolName und --toolDescription passen die Anzeige des Suchwerkzeugs für den KI-Assistenten an.
Alternativ erlauben einige Clients die direkte Angabe des vollständigen Befehls. Sie können dasselbe wie in Beispiel 1 erreichen, indem Sie Folgendes verwenden:
Beispiel 2: Verwendung eines vorgefertigten, gebrandeten MCP-Servers (z. B. Tyk-Paket)
Wenn ein Team ein vorgefertigtes Paket mit spezifischer Dokumentation veröffentlicht (z. B. @tyk-technologies/docs-mcp ), vereinfacht sich die Konfiguration, da die Inhaltsquelle und die Tooldetails in dieses Paket integriert sind. Das Argument -y wird weiterhin für npx empfohlen.
Dieser Ansatz eignet sich ideal für die Bereitstellung standardisierter Suchfunktionen für offizielle Dokumentationen oder Codebasen. Weitere Informationen finden Sie weiter unten im Abschnitt „Erstellen eines eigenen vorgefertigten MCP-Servers“.
Hier ist ein Beispiel, wie das Tyk-Team einen eigenen MCP-Dokumentationsserver erstellt hat : https://github.com/TykTechnologies/docs-mcp .
Erstellen Sie eine Datei docs-mcp.config.json im Stammverzeichnis, um die Standardinhaltsquelle und die MCP-Tooldetails zu definieren, die während des Builds und zur Laufzeit verwendet werden (sofern sie nicht durch CLI-Argumente oder Umgebungsvariablen überschrieben werden).
includeDir : (Build/Runtime) Absoluter Pfad zu einem lokalen Verzeichnis, dessen Inhalt während des Builds in das data kopiert oder zur Laufzeit direkt verwendet wird, wenn dataDir nicht angegeben ist. Verwenden Sie dies ODER gitUrl .gitUrl : (Build/Runtime) URL des Git-Repositorys. Verwenden Sie diese oder includeDir .autoUpdateInterval 0 (Standard) ist, versucht der Server, ein .tar.gz Archiv direkt herunterzuladen (aktuell wird die GitHub-URL-Struktur angenommen: https://github.com/{owner}/{repo}/archive/{ref}.tar.gz ). Dies ist schneller, unterstützt aber keine Updates.autoUpdateInterval > 0, führt der Server einen git clone durch und aktiviert regelmäßige Updates.gitRef : (Build/Runtime) Der zu verwendende Branch, Tag oder Commit-Hash aus der gitUrl (Standard: main ). Wird sowohl für den Tarball-Download als auch für Git-Clone/Pull verwendet.autoUpdateInterval : (Laufzeit) Intervall in Minuten für die automatische Überprüfung auf Git-Updates (Standard: 0, deaktiviert). Ein Wert > 0 aktiviert Git-Klonen und regelmäßige git pull Operationen. Der git Befehl muss im Systempfad verfügbar sein.dataDir : (Laufzeit) Pfad zum Verzeichnis mit dem zur Laufzeit zu durchsuchenden Inhalt. Überschreibt Inhalte aus includeDir oder gitUrl die in der Konfigurationsdatei definiert oder im Paket integriert sind. Nützlich, um den Server ohne Neuaufbau auf Live-Daten zu verweisen.toolName : (Build/Runtime) Der Name des vom Server bereitgestellten MCP-Tools (Standard: search_docs ). Wählen Sie einen aussagekräftigen, zum Inhalt passenden Namen.toolDescription : (Build/Runtime) Die Beschreibung des MCP-Tools, die den KI-Assistenten angezeigt wird (Standard: „Dokumentation mithilfe der Probe-Suchmaschine durchsuchen.“).ignorePatterns : (Build/Runtime) Ein Array von Glob-Mustern.enableBuildCleanup : (Build) Wenn „ true (Standard), werden nach dem Build-Schritt gängige Binär-/Mediendateien (Bilder, Videos, Archive usw.) sowie Dateien größer als 100 KB aus dem data entfernt. Auf false setzen, um diese Bereinigung zu deaktivieren.includeDir während des Builds: Dateien, die diesen Mustern entsprechen, werden beim Kopieren in data ausgeschlossen. .gitignore -Regeln werden ebenfalls beachtet.gitUrl oder dataDir zur Laufzeit: Dateien, die diesen Mustern im data entsprechen, werden vom Suchindexer ignoriert.Vorrang:
--dataDir , --gitUrl usw.) und Umgebungsvariablen ( DATA_DIR , GIT_URL usw.) überschreiben alle anderen Einstellungen. CLI-Argumente haben Vorrang vor Umgebungsvariablen.docs-mcp.config.json ( includeDir , gitUrl , toolName usw.) definieren Standardwerte, die während npm run build verwendet werden und auch als Laufzeitstandardwerte dienen, wenn sie nicht überschrieben werden.toolName: 'search_docs' , autoUpdateInterval: 5 ).Hinweis: Wenn sowohl includeDir als auch gitUrl in derselben Konfigurationsquelle bereitgestellt werden (z. B. beide in der Konfigurationsdatei oder beide als CLI-Argumente), hat gitUrl Vorrang.
Sie können dieses Projekt als Vorlage verwenden, um Ihr eigenes npm-Paket mit vorinstallierter Dokumentation oder Code zu erstellen und zu veröffentlichen. Dies ermöglicht Benutzern eine konfigurationsfreie Erfahrung (wie im obigen Beispiel 2).
docs-mcp.config.json : Definieren Sie das includeDir oder gitUrl das auf Ihre Inhaltsquelle verweist. Legen Sie den Standardwert toolName und toolDescription fest.package.json : Ändern Sie den name (z. B. @my-org/my-docs-mcp ), version , description usw.npm run build aus. Dadurch wird Ihr Inhalt in das data geklont/kopiert und das Paket bereitgestellt.npm publish aus (Sie müssen die npm-Authentifizierung konfiguriert haben).Jetzt können Benutzer Ihren spezifischen Dokumentationsserver einfach ausführen: npx @my-org/my-docs-mcp@latest .
(Die vorherigen Abschnitte „Ausführen“, „Dynamische Konfiguration zur Laufzeit“ und „Umgebungsvariablen“ wurden entfernt, da die Verwendung npx mit Argumenten innerhalb von Clientkonfigurationen jetzt die primäre dokumentierte Methode ist.)
Dieser MCP-Server stellt verbundenen KI-Assistenten über das Model Context Protocol ein Suchtool zur Verfügung. Name und Beschreibung des Tools sind konfigurierbar (siehe Abschnitt „Konfiguration“). Es durchsucht den Inhalt im aktuell aktiven data (bestimmt durch Build-Einstellungen, Konfigurationsdatei, CLI-Argumente oder Umgebungsvariablen).
Werkzeugparameter:
query : Eine Abfrage in natürlicher Sprache oder Schlüsselwörter, die beschreiben, wonach gesucht werden soll (z. B. „Gateway konfigurieren“, „Beispiel für eine Datenbankverbindung“, „Benutzerauthentifizierung“). Der Server nutzt die Suchfunktionen von Probe, um relevante Inhalte zu finden. (Erforderlich)page : Die Seitenzahl der Ergebnisse bei vielen Treffern. Standardmäßig 1, falls nicht angegeben. (Optional)Beispiel für einen Toolaufruf (unter Verwendung von search_tyk_docs aus Verwendungsbeispiel 1):
Beispiel für einen Tool-Aufruf (mit dem Tool aus dem Paket @tyk/docs-mcp ):
Angenommen, das vorgefertigte Paket @tyk/docs-mcp hat seinen Toolnamen als search_tyk_official_docs definiert:
(Der vorherige Abschnitt „Veröffentlichen als npm-Paket“ wurde durch den obigen Abschnitt „Erstellen Ihres eigenen vorgefertigten MCP-Servers“ ersetzt.)
MIT
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Ein flexibler Model Context Protocol-Server, der Dokumentationen oder Codebasen für KI-Assistenten durchsuchbar macht und es Benutzern ermöglicht, mit Code oder Dokumenten zu chatten, indem sie einfach auf ein Git-Repository oder einen Git-Ordner verweisen.