Die Integration von KI-Entwicklungsagenten in Ihren Workflow erfordert strukturierte Schnittstellen, die es Modellen ermöglichen, Dokumentationskontexte effizient abzufragen, zu lesen und zu validieren. docmd erfüllt diesen Bedarf über einen nativen Model Context Protocol (MCP) Server und automatisch generierte Agent Skills-Anweisungen.
Model Context Protocol (MCP) Einrichtung
Das Model Context Protocol verbindet LLM-Umgebungen direkt über stdio mit Ihren lokalen Workspace-Tools.
1. Claude Desktop Integration
Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:
{
"mcpServers": {
"docmd": {
"command": "npx",
"args": ["@docmd/core", "mcp"],
"cwd": "/pfad/zu/ihrem/docs/projekt"
}
}
}
2. IDE-Integration (Cursor / Windsurf)
Fügen Sie im MCP-Einstellungsbereich Ihres Editors einen neuen Server mit dem stdio-Transport hinzu:
- Befehl:
npx @docmd/core mcp - Transport:
stdio
Verfügbare MCP-Tools
Sobald verbunden, können Agenten 6 primäre Tool-Handler ausführen:
search_docs(query): Führt Volltextsuchen über Workspace-Dateien hinweg aus.list_docs(subdir?): Listet relative Markdown-Dateipfade auf, optional auf Sprachversion oder Sprache beschränkt.read_doc(route): Liest rohe Markdown-Inhalte für eine geschützte Datei-Route.get_config(): Inspeziert aufgelöstedocmd.config.json-Optionen mit geschwärzten Geheimwerten.validate_docs(): Prüft interne Link-Ziele und meldet defekte Anker.get_llms_context(): Ruft den konsolidiertenllms-full.txt-Kontext ab.
Agent Skills nutzen (SKILL.md)
Die Ausführung von docmd init generiert eine SKILL.md-Datei im Root-Verzeichnis Ihres Repositories. Dieses Dokument dient als Bedienungsanleitung für KI-Agenten, die an Ihrer Codebasis arbeiten.
- Kontext initialisieren: Weisen Sie Agenten an,
SKILL.mdzu Beginn einer Sitzung zu prüfen, um eigene Callouts, OpenAPI-Markup und Dateistrukturen zu erlernen. - Edits validieren: Weisen Sie Agenten an, nach dem Bearbeiten von Markdown-Dateien
validate_docsodernpx @docmd/core validateauszuführen, um kaputte Links zu verhindern.