mcp-docs

Generischer MCP-Server, der Markdown-Dokumentation für LLMs bereitstellt und es ihnen ermöglicht, Software-Dokumentationen zu durchsuchen und Fragen dazu zu beantworten.

Die Identität des Servers (Name, Anweisungen, Kategorie-Labels) wird vollständig durch das Verzeichnis docs/ bestimmt – ein separates Repository, das neben diesem geklont wird.

Anforderungen

• Python 3.14+

• uv

Einrichtung

1. Klonen des Dokumentations-Repositorys

Das Verzeichnis docs/ muss existieren, bevor der Server gestartet werden kann. Klonen Sie das Dokumentations-Repository hinein:

git clone <docs-repo-url> docs

2. Abhängigkeiten installieren

uv sync

Struktur des docs/-Verzeichnisses

Der Server erkennt Kategorien automatisch anhand von Unterverzeichnissen. Die einzige erforderliche Datei ist config.toml im Stammverzeichnis von docs/.

docs/
├── config.toml          # required — project identity
├── <category>/
│   ├── <topic>.md
│   └── ...
└── <category>/
    └── ...

config.toml

[project]
name = "my-project"
instructions = """
System instructions for the LLM. Describe what this documentation covers
and how the model should use the available tools.
"""

[categories]
folder-name = "Human-readable label"

• [project] ist erforderlich. name identifiziert den Server; instructions leitet das LLM an.

• [categories] ist optional. Jedes Unterverzeichnis, das nicht aufgeführt ist, erhält automatisch ein Label in Title-Case (my-folder → My Folder).

• Dateien in img/-Unterverzeichnissen werden nie bereitgestellt.

Verwendung

Server starten (stdio-Modus)

uv run main.py

Entwicklung mit dem MCP Inspector

uv run mcp dev main.py

Öffnet den MCP Inspector im Browser. Um eine Verbindung zu einem laufenden SSE- oder Streamable-HTTP-Server herzustellen, starten Sie diesen zuerst und verweisen den Inspector auf den ausgegebenen Endpunkt:

uv run main.py --transport sse
uv run main.py --transport streamable-http

Konfiguration mit Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

{
  "mcpServers": {
    "my-project": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-docs", "run", "main.py"]
    }
  }
}

Konfiguration mit Claude Code

claude mcp add my-project -- uv --directory /path/to/mcp-docs run main.py

Funktionen

Tools

Ressourcen