Freedcamp MCP Server

Dies ist eine Model Context Protocol (MCP)-Serverimplementierung für die Freedcamp-Aufgabenverwaltung. Sie bietet Tools zum Erstellen, Aktualisieren und Löschen von Aufgaben in Freedcamp-Projekten.

Merkmale

• Erstellen Sie neue Aufgaben mit Titel, Beschreibung, Priorität, Fälligkeitsdatum und Zuständigem

• Aktualisieren vorhandener Aufgaben einschließlich Statusänderungen

• Aufgaben löschen

• Unterstützung von Umgebungsvariablen für Anmeldeinformationen

• Fehlerbehandlung und Validierung

Voraussetzungen

• Node.js 17 oder höher

• Typoskript

• Freedcamp-Konto mit API-Zugriff

• API-Schlüssel und Geheimnis von Freedcamp

• Projekt-ID von Freedcamp

Installation (nur für den manuellen Aufruf, nicht erforderlich für die Verwendung mit einer IDE oder einem anderen MCP-Desktop-Client)

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten:

3. Erstellen Sie im Stammverzeichnis eine .env Datei mit Ihren Freedcamp-Anmeldeinformationen:

Verwendung

Ausführen des Servers

Erstellen Sie zuerst den TypeScript-Code:

Starten Sie dann den Server:

Ausführen des Test-Harnesses

Das Projekt umfasst ein umfassendes Test-Harness, das alle MCP-Funktionen überprüft:

Das Test-Harness führt die folgenden Prüfungen durch:

1. Serverinitialisierung mit der richtigen Protokollversion

2. Tool-Auflistung und Fähigkeitsüberprüfung

3. Aufgabenerstellung mit verschiedenen Parametern

4. Aufgabenaktualisierungen einschließlich Statusänderungen

5. Aufgabenauflistung und -überprüfung

Verfügbare Tools

1. freedcamp_add_task

   • Erstellt eine neue Aufgabe in Freedcamp

   • Parameter:

     • title (erforderlich): Aufgabentitel

     • description (optional): Aufgabenbeschreibung

     • priority (optional): Aufgabenpriorität (0-3)

     • due_date (optional): Fälligkeitsdatum der Aufgabe (JJJJ-MM-TT)

     • assigned_to_id (optional): Benutzer-ID, der die Aufgabe zugewiesen werden soll

2. freedcamp_update_task

   • Aktualisiert eine vorhandene Aufgabe

   • Parameter:

     • task_id (erforderlich): ID der zu aktualisierenden Aufgabe

     • title (optional): Neuer Aufgabentitel

     • description (optional): Neue Aufgabenbeschreibung

     • priority (optional): Neue Aufgabenpriorität (0-3)

     • due_date (optional): Neues Fälligkeitsdatum (JJJJ-MM-TT)

     • assigned_to_id (optional): Neue Benutzer-ID, der die Aufgabe zugewiesen werden soll

     • status (optional): Neuer Aufgabenstatus (0=offen, 1=abgeschlossen, 2=geschlossen)

3. freedcamp_list_tasks

   • Listet alle Aufgaben im konfigurierten Freedcamp-Projekt auf

   • Keine Parameter erforderlich (verwendet Projekt-ID aus Umgebungsvariablen)

   • Gibt eine Liste der Aufgaben mit ihren Details zurück

IDE-Integration

Der Server kann direkt mit npx ausgeführt werden, ohne das Repository zu klonen.

Cursor

1. Öffnen (oder erstellen) Sie .cursor/mcp.json in Ihrem Projektstamm.

2. Fügen Sie Ihre Freedcamp MCP-Serverkonfiguration hinzu:

   { "mcpServers": { "freedcamp": { "command": "npx", "args": ["freedcamp-mcp"], "env": { "FREEDCAMP_API_KEY": "your_api_key", "FREEDCAMP_API_SECRET": "your_api_secret", "FREEDCAMP_PROJECT_ID": "your_project_id" } } } }

3. Starten Sie Cursor neu oder laden Sie MCP-Server neu.

Roo

1. Öffnen (oder erstellen) Sie Ihre Roo MCP-Konfigurationsdatei (normalerweise roo.mcp.json oder ähnlich).

2. Fügen Sie Ihre Freedcamp MCP-Serverkonfiguration hinzu:

   { "mcpServers": { "Freedcamp": { "transport": "stdio", "command": "npx", "args": ["freedcamp-mcp"], "env": { "FREEDCAMP_API_KEY": "your_api_key", "FREEDCAMP_API_SECRET": "your_api_secret", "FREEDCAMP_PROJECT_ID": "your_project_id" } } } }