freedcamp

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" } } } }