Skip to main content
Glama
serverless-dna

MkDocs MCP Search Server

MkDocs MCP-Suchserver

Ein Model Context Protocol (MCP)-Server, der Suchfunktionen für alle MkDocs- basierten Websites bereitstellt. Dieser Server basiert auf der bestehenden MkDocs-Suchimplementierung und verwendet die Suchmaschine Lunr.Js.

Claude Desktop Schnellstart

Befolgen Sie die Installationsanweisungen. Bitte folgen Sie der Schnellstartanleitung zum Model Context Protocol für Claude Desktop-Benutzer . Sie müssen der MCP-Konfigurationsdatei einen Abschnitt wie folgt hinzufügen:

{ "mcpServers": { "my-docs": { "command": "npx", "args": [ "-y", "@serverless-dna/mkdocs-mcp", "https://your-doc-site", "Describe what you are enabling search for to help your AI Agent" ] } } }

Related MCP server: Claude AI Documentation Assistant

Überblick

Dieses Projekt implementiert einen MCP-Server, der es Large Language Models (LLMs) ermöglicht, alle veröffentlichten mkdocs-Dokumentationsseiten zu durchsuchen. Es nutzt lunr.js für effiziente lokale Suchfunktionen und liefert Ergebnisse, die zusammengefasst und Benutzern präsentiert werden können.

Merkmale

  • MCP-kompatibler Server zur Integration mit LLMs

  • Lokale Suche mit lunr.js-Indizes

  • Versionsspezifische Dokumentationssuchfunktion

Installation

# Install dependencies pnpm install # Build the project pnpm build

Verwendung

Der Server kann als MCP-Server ausgeführt werden, der über stdio kommuniziert:

npx -y @serverless-dna/mkdocs-mcp https://your-doc-site.com

Suchwerkzeug

Der Server stellt ein search_docs Tool mit den folgenden Parametern bereit:

  • search : Die Suchabfragezeichenfolge

  • version : Optionale Versionszeichenfolge (standardmäßig „neueste“)

Entwicklung

Gebäude

pnpm build

Testen

pnpm test

Claude Desktop MCP-Konfiguration

Während der Entwicklung können Sie den MCP-Server mit Claude Desktop mit der folgenden Konfiguration ausführen.

Die folgende Konfiguration zeigt die Ausführung in Windows Claude Desktop während der Entwicklung mit dem Windows-Subsystem für Linux (WSL). Mac- oder Linux-Umgebungen können auf ähnliche Weise ausgeführt werden.

Die Ausgabe ist eine gebündelte Datei, die es dem unter Windows installierten Node ermöglicht, den MCP-Server auszuführen, da alle Abhängigkeiten gebündelt sind.

{ "mcpServers": { "powertools": { "command": "node", "args": [ "\\\\wsl$\\Ubuntu\\home\\walmsles\\dev\\serverless-dna\\mkdocs-mcp\\dist\\index.js", "Search online documentation" ] } } }

Wie es funktioniert

  1. Der Server lädt vorgefertigte lunr.js-Indizes für jede unterstützte Laufzeit

  2. Wenn eine Suchanfrage eingeht, geschieht Folgendes:

    • Lädt den entsprechenden Index basierend auf der Version (derzeit auf die neueste festgelegt)

    • Führt die Suche mit lunr.js durch

    • Gibt die Suchergebnisse als JSON zurück

  3. Der LLM kann diese Ergebnisse dann verwenden, um relevante Dokumentationsseiten zu finden

Lizenz

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

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/serverless-dna/mkdocs-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server