MCP-Docs Tools
Alle 9 verfügbaren MCP-Tools für Dokumentations-Management.
Übersicht
| Tool | Beschreibung |
|---|---|
docs_list | Dokumente auflisten mit Filtern |
docs_get | Dokument nach ID oder Pfad abrufen |
docs_create | Neues Dokument erstellen |
docs_update | Dokument bearbeiten |
docs_delete | Dokument löschen |
docs_move | Position im Baum ändern |
docs_hierarchy | Kompletter Dokumentationsbaum |
docs_search | Volltextsuche |
docs_statistics | Statistiken abrufen |
docs_list
Listet Dokumente mit optionalen Filtern auf.
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
status | string | - | Filter: draft, published, archived |
parent_id | int | - | Filter nach Parent-ID |
search | string | - | Volltextsuche in Titel/Beschreibung |
compact | bool | True | True = nur id/path/title/status (ohne Content) |
limit | int | 20 | Max. Ergebnisse (1-100) |
# Alle veröffentlichten Dokumente (kompakt)
docs_list(status="published")
# Kinder eines Parents
docs_list(parent_id=1)
# Suche mit vollständigen Daten
docs_list(search="SSH", compact=False)docs_get
Holt ein Dokument nach ID oder Pfad.
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
id | int | - | Dokument-ID |
path | string | - | Dokument-Pfad (alternativ zu ID) |
include_children | bool | False | Kind-Dokumente einschließen |
include_breadcrumb | bool | False | Breadcrumb-Pfad einschließen |
# Nach ID
docs_get(id=1)
# Nach Pfad mit Kindern
docs_get(path="/server/ssh", include_children=True)
# Mit Breadcrumb
docs_get(id=5, include_breadcrumb=True)docs_create
Erstellt ein neues Dokument.
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
title | string | required | Dokumenttitel |
slug | string | required | URL-Slug (eindeutig pro Parent) |
content | string | "" | HTML-Inhalt |
description | string | - | Kurzbeschreibung |
parent_id | int | - | ID des Parent-Dokuments (NULL für Root) |
status | string | "draft" | draft, published, archived |
sort_order | int | 0 | Sortierung innerhalb Parent |
# Root-Dokument erstellen
docs_create(
title="Neues Kapitel",
slug="neues-kapitel",
content="Neues Kapitel
",
status="published"
)
# Unterkapitel erstellen
docs_create(
title="Unterseite",
slug="unterseite",
parent_id=1,
content="Unterseite
"
)docs_update
Aktualisiert ein Dokument.
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
id | int | required | Dokument-ID |
title | string | - | Neuer Titel |
content | string | - | Neuer Inhalt |
description | string | - | Neue Beschreibung |
status | string | - | Neuer Status |
# Inhalt aktualisieren
docs_update(id=5, content="Neuer Inhalt
")
# Status ändern
docs_update(id=5, status="archived")docs_delete
Löscht ein Dokument.
| Parameter | Typ | Beschreibung |
|---|---|---|
id | int | Dokument-ID |
Achtung: Kind-Dokumente werden zu Root-Dokumenten (parent_id=NULL).
docs_move
Verschiebt ein Dokument zu einem neuen Parent.
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
id | int | required | Dokument-ID |
new_parent_id | int | - | Neue Parent-ID (NULL für Root) |
new_sort_order | int | - | Neue Sortierung |
# Zu anderem Parent verschieben
docs_move(id=5, new_parent_id=10)
# Zu Root verschieben
docs_move(id=5, new_parent_id=None)docs_hierarchy
Gibt den kompletten Dokumentationsbaum zurück.
docs_hierarchy()Liefert verschachtelte Struktur mit allen Dokumenten und ihren Kindern.
docs_search
Volltextsuche in allen Dokumenten.
| Parameter | Typ | Default | Beschreibung |
|---|---|---|---|
query | string | required | Suchbegriff |
limit | int | 20 | Max. Ergebnisse |
# Suche nach Begriff
docs_search(query="SSH")docs_statistics
Gibt Statistiken über alle Dokumente zurück.
docs_statistics()Liefert: Anzahl nach Status, Tiefe, letzte Änderungen.