Project Hub - MCP-Tools

Referenz der 43 Tools des Project-Hub-MCP-Servers project-hub-mcp: Projekte, Verknüpfungen, Kontakte, Notizen, Anhänge, Suche, Wissen, Projekttypen, Berichte, Export und Import.

Project Hub - MCP-Tools

English Version

← Zurück zur Übersicht

Der MCP-Server heißt project-hub-mcp und stellt 43 Tools bereit. Die Skills rufen sie auf. Du kannst Claude aber auch direkt bitten, ein Tool zu verwenden, etwa für Projekt-Verknüpfungen.

Alle Projekt-, Kontakt-, Notiz- und Sitzungsdaten liest und schreibt das Plugin ausschließlich über diese Tools. Die SQLite-Datei sollte nicht direkt bearbeitet werden.

Sitzung

Tool	Zweck
`tool_get_session`	Aktives Projekt und zuletzt genutzten Skill lesen
`tool_set_session`	Aktives Projekt per Slug oder Name setzen
`tool_clear_session`	Aktive Auswahl löschen

Projekte

Tool	Zweck
`tool_list_projects`	Projekte seitenweise auflisten, optional nach Status (`active`, `paused`, `completed`, `cancelled`) gefiltert
`tool_get_project`	Projekt per Slug oder Name laden, inklusive Verknüpfungen. Die Namenssuche ignoriert Groß- und Kleinschreibung nur bei ASCII-Buchstaben
`tool_get_project_by_id`	Projekt per numerischer ID laden
`tool_create_project`	Projekt und Docs-Ordner anlegen, Fehler bei vorhandenem Slug
`tool_update_project`	Felder ändern, nur nicht leere Werte werden geschrieben
`tool_delete_project`	Projekt unwiderruflich löschen
`tool_list_docs`	Dateien im Docs-Ordner eines Projekts auflisten

tool_delete_project entfernt Kontakte, Notizen und Verknüpfungen des Projekts und seinen gesamten Docs-Ordner samt Anhängen. Geteilte Kontakte werden vorher einem anderen Projekt zugeordnet. Das Tool hat keine Schutzprüfung und ist für die Test-Skills gedacht, kein Skill für den normalen Gebrauch ruft es auf.

Projekt-Verknüpfungen

Tool	Zweck
`tool_link_project`	Zwei Projekte verknüpfen: `successor`, `predecessor` oder `related`
`tool_unlink_project`	Verknüpfung entfernen, unabhängig von Richtung und Typ

successor heißt: das erste Projekt ist Nachfolger des zweiten. predecessor ist die Gegenrichtung, related ist symmetrisch.
Ein Projektpaar kann nur eine Verknüpfung haben. Zum Ändern zuerst entknüpfen.
Ein Projekt lässt sich nicht mit sich selbst verknüpfen.

Kontakte

Tool	Zweck
`tool_list_contacts`	Kontakte eines Projekts, optional nach `internal` oder `external`
`tool_list_shared_contacts`	Alle geteilten Kontakte, mit Herkunftsprojekt
`tool_add_contact`	Kontakt anlegen
`tool_update_contact`	Kontakt ändern, auch `is_shared`
`tool_delete_contact`	Kontakt löschen
`tool_search_contacts`	Suche in Name, Rolle, E-Mail, Firma, mit `project_id=0` über alle Projekte

Regeln für geteilte Kontakte:

Nur interne Kontakte können geteilt werden.
Ein Kontakt mit gleichem Namen (nach Vereinheitlichung von Schreibweise, Umlauten und Reihenfolge "Nachname, Vorname") oder gleicher E-Mail-Adresse wie ein geteilter Kontakt wird abgelehnt und lässt sich nicht erzwingen.
Bei sehr ähnlichen Namen blockt der Server nur Kontakte, die selbst geteilt werden sollen. Mit force=true lässt sich das nach ausdrücklicher Bestätigung umgehen.
Listen sind seitenweise (Standard 50 Einträge, limit und offset).

Notizen

Tool	Zweck
`tool_list_notes`	Notizen eines Projekts, neueste zuerst, optional nach Typ gefiltert
`tool_get_note`	Einzelne Notiz laden
`tool_add_note`	Notiz anlegen, optional mit `source_paths` zum Sichern der Originaldateien
`tool_update_note`	Titel, Inhalt, Typ oder Agenda ändern, nur nicht leere Werte werden geschrieben
`tool_delete_note`	Notiz löschen
`tool_search_notes`	Suche in Titel und Inhalt, mit `project_id=0` über alle Projekte

Gültige Notiztypen: note, meeting-notes, email, decision, action-item.

Die beiden Such-Tools (tool_search_contacts, tool_search_notes) arbeiten mit SQL LIKE. Groß- und Kleinschreibung wird nur bei ASCII-Buchstaben ignoriert, Umlaute müssen exakt übereinstimmen. % und _ im Suchbegriff werden nicht maskiert und wirken als Platzhalter.

Anhänge

Anhänge gehören zu einer Notiz und werden über die Notiz-ID angesprochen.

Tool	Zweck
`tool_attach_file`	Eine Datei in den Anhangsordner der Notiz kopieren
`tool_attach_files`	Mehrere Dateien auf einmal, einzelne Fehler brechen den Rest nicht ab
`tool_list_attachments`	Anhänge einer Notiz auflisten
`tool_remove_attachment`	Anhang per Dateiname entfernen, inklusive Markdown-Kopie

Schutzregeln:

Nur Dateien unterhalb Deines Home-Verzeichnisses werden angenommen.
Pfade mit versteckten Ordnern oder Dateien (Namen mit führendem Punkt, etwa ~/.ssh/) werden abgelehnt.
Verzeichnisse und Sonderdateien werden abgelehnt.
~ wird nicht aufgelöst, es braucht vollständige absolute Pfade.
Eine vorhandene Datei gleichen Namens wird nicht überschrieben, der Server hängt einen Zähler an (rechnung-2.pdf).
Für Dateien über 10 MB schreibt der Server nur eine Warnung ins Log.
Zu PDF, DOCX, XLSX und weiteren Formaten legt der Server nach Möglichkeit eine <name>.md-Datei daneben. Bilder, Markdown-Dateien und bereits vorhandene Namen werden übersprungen, und ein Fehler bei der Umwandlung verhindert den Anhang nicht.

Wissensdokumente

Tool	Zweck
`tool_list_knowledge`	Themen eines Projekttyps auflisten
`tool_get_knowledge`	Ein Dokument laden
`tool_get_all_knowledge`	Alle Dokumente eines Typs mit Inhalt laden
`tool_save_knowledge`	Dokument schreiben oder überschreiben
`tool_delete_knowledge`	Dokument löschen
`tool_sync_knowledge_templates`	Mitgelieferte Vorlagen mit den installierten abgleichen, mit `force=true` kopieren

Das Thema ist der Dateiname ohne .md. Das Thema wird gegen Pfade außerhalb des Typordners geprüft, der Projekttyp dagegen nicht (siehe Datenschutz und Sicherheit).

Projekttypen und Vorlagen

Tool	Zweck
`tool_list_project_types`	Eingebaute und eigene Typen auflisten
`tool_get_project_type`	Details und README eines Typs laden
`tool_create_project_type`	Eigenen Typ anlegen
`tool_delete_project_type`	Eigenen Typ löschen, eingebaute sind geschützt
`tool_get_project_template`	Vorlage eines Typs holen, sonst die generische
`tool_create_project_from_template`	Projekt aus ausgefüllter Vorlage (Text oder `.md`-Datei) anlegen

Berichte, Export und Import

Tool	Zweck
`tool_generate_report`	HTML-Bericht `full`, `summary` oder `all-projects` schreiben
`tool_export_project`	Projekt mit Kontakten, Notizen und Verknüpfungen als JSON exportieren
`tool_import_project`	Projekt aus einer Exportdatei einlesen, Strategie `skip`, `rename` oder `overwrite`

Der Parameter offline von tool_generate_report ist reserviert und hat keine Wirkung. Der Bericht listet alle Action Items ohne Erledigt-Filter. Details zu Export und Import stehen unter Technische Details.