Project Hub - Installation

Voraussetzungen, Installation per Marketplace oder Git Clone, Ersteinrichtung mit /project-hub:setup, Updates und Entfernen des Project-Hub-Plugins.

Project Hub - Installation

English Version

← Zurück zur Übersicht

Voraussetzungen

Komponente	Anforderung
Claude Code	mit Plugin-Unterstützung
Python	3.11 oder neuer
Betriebssystem	Linux, macOS oder Windows (nativ, kein WSL nötig)
Netzwerk	nur bei der Einrichtung, um die Python-Pakete zu laden

Ein API-Schlüssel ist nicht nötig. Die Python-Pakete stehen in der requirements.txt des Plugins: mcp[cli] (Version 2.x), jinja2, pyyaml und markitdown (mit den Extras für PDF, DOCX, XLSX und XLS).

Installationswege

Marketplace

claude plugin marketplace add markus-michalski/project-hub
claude plugin install project-hub@project-hub

Updates laufen danach über claude plugin update project-hub.

Git Clone

git clone https://github.com/markus-michalski/project-hub ~/.claude/plugins/project-hub

Danach trägst Du das Plugin in der ~/.claude/settings.json ein:

{
  "enabledPlugins": {
    "project-hub@project-hub": true
  }
}

Auch bei diesem Weg ist die Ersteinrichtung nötig. Der MCP-Server startet über das Python aus ~/.project-hub/venv, das erst /project-hub:setup anlegt.

Ersteinrichtung

/project-hub:setup

Der Skill arbeitet diese Schritte ab:

Er sucht einen funktionierenden Python-Interpreter (python3, python, py -3 und unter Windows bekannte Installationspfade).
Er legt ~/.project-hub/ an.
Er erstellt das virtuelle Environment ~/.project-hub/venv, falls es fehlt.
Er synchronisiert die Abhängigkeiten aus der requirements.txt und entfernt dabei ein altes fastmcp-Paket.
Er kopiert config.example.yaml nach ~/.project-hub/config.yaml, falls noch keine Konfiguration existiert. Eine vorhandene Datei wird nicht überschrieben.
Er warnt, wenn db_path auf einen Cloud-Sync-Ordner oder einen Netzwerkpfad zeigt.
Er fragt, für welche Projekttypen die Wissensdokument-Vorlagen nach ~/.project-hub/knowledge/ kopiert werden sollen. Vorhandene Dateien bleiben unverändert.
Er initialisiert die Datenbank.

Starte Claude Code anschließend neu, damit der MCP-Server geladen wird.

Windows: Wenn python oder python3 mit Exit-Code 49 und ohne Ausgabe scheitert, ist das der Microsoft-Store-Platzhalter. Der Skill fällt dann automatisch auf py -3 zurück.

Installation prüfen

/project-hub:session-start prüft, ob venv, config.yaml und die Python-Abhängigkeiten vorhanden sind, und verweist bei Lücken auf /project-hub:setup. Mit /project-hub:help siehst Du alle Skills.

Updates

Marketplace: claude plugin update project-hub, danach Claude Code neu starten.
Nach einem Update kannst Du /project-hub:setup erneut ausführen. Der Skill synchronisiert die Abhängigkeiten immer und lässt vorhandene Daten und Konfiguration unberührt.
Aktualisierte Wissensdokument-Vorlagen des Plugins gleichst Du mit /project-hub:knowledge sync ab. Der Skill zeigt zuerst, was neu oder geändert ist, und überschreibt erst nach Bestätigung.
Das Datenbankschema wird beim Start des MCP-Servers automatisch ergänzt. Fehlende Tabellen und Spalten legt der Server selbst an.

Entfernen

Das Repository beschreibt keinen eigenen Deinstallationsweg. Deine Daten liegen außerhalb des Plugin-Verzeichnisses und bleiben deshalb beim Entfernen des Plugins erhalten:

Pfad	Inhalt
`~/.project-hub/`	Konfiguration, Datenbank, virtuelles Environment, Wissensdokumente, eigene Projekttypen, Berichte, Exporte
`docs_root` (siehe Konfiguration)	Projektordner mit Notizdateien und Anhängen

Wenn Du alles entfernen willst, löschst Du diese Ordner manuell. Das ist unwiderruflich, denn die Datenbank enthält alle Projekte, Kontakte und Notizen.