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

Related MCP server: Basecamp MCP Server

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:

git clone <repository-url>
cd freedcamp-mcp

2. Installieren Sie Abhängigkeiten:

npm install

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

FREEDCAMP_API_KEY=your_api_key
FREEDCAMP_API_SECRET=your_api_secret
FREEDCAMP_PROJECT_ID=your_project_id

Verwendung

Ausführen des Servers

Erstellen Sie zuerst den TypeScript-Code:

npm run build

Starten Sie dann den Server:

npm start

Ausführen des Test-Harnesses

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

npm test

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