TaskFlow MCP

TaskFlow MCP 🔄✅

Ein Task-Management-Model-Context-Protocol-(MCP)-Server zum Planen und Ausführen von Aufgaben mit KI-Assistenten.

🌟 Übersicht

TaskFlow MCP ist ein spezialisierter Server, der KI-Assistenten dabei unterstützt, Benutzeranfragen in überschaubare Aufgaben aufzuteilen und deren Erledigung zu verfolgen. Er erzwingt einen strukturierten Workflow mit Benutzergenehmigungsschritten, um sicherzustellen, dass Aufgaben ordnungsgemäß verfolgt werden und Benutzer die Kontrolle über den Prozess behalten.

✨ Funktionen

📋 Aufgabenplanung : Teilen Sie komplexe Anfragen in überschaubare Aufgaben auf
🔍 Unteraufgaben : Teilen Sie Aufgaben in kleinere, überschaubarere Unteraufgaben auf
📊 Fortschrittsverfolgung : Verfolgen Sie den Status von Aufgaben, Unteraufgaben und Anfragen mit visuellen Fortschrittstabellen
👍 Benutzergenehmigung : Erzwingen Sie Benutzergenehmigungsschritte, um Qualität und Kontrolle sicherzustellen
💾 Persistenz : Speichern Sie Aufgaben und Anforderungen auf der Festplatte, damit sie über mehrere Sitzungen hinweg bestehen bleiben
🔄 Flexibles Management : Fügen Sie Aufgaben und Unteraufgaben nach Bedarf hinzu, aktualisieren oder löschen Sie sie
📝 Detaillierte Berichte : Zeigen Sie Aufgabendetails und Fortschrittstabellen an
📤 Exportoptionen : Exportieren Sie Aufgabenpläne und Statusberichte in den Formaten Markdown, JSON oder HTML
📦 Abhängigkeiten : Verfolgen Sie Abhängigkeiten auf Projekt- und Aufgabenebene mit Versionsinformationen
📌 Notizen : Fügen Sie Notizen auf Projektebene für wichtige Informationen und Präferenzen hinzu

🚀 Installation

Globale Installation

npm install -g @pinkpixel/taskflow-mcp

Lokale Installation

npm install @pinkpixel/taskflow-mcp

🛠️ Verwendung

Starten des Servers

Bei globaler Installation:

taskflow-mcp

Bei lokaler Installation:

npx taskflow-mcp

Konfiguration

Standardmäßig speichert TaskFlow MCP Aufgaben in ~/Documents/tasks.json . Sie können dies ändern, indem Sie die Umgebungsvariable TASK_MANAGER_FILE_PATH festlegen:

TASK_MANAGER_FILE_PATH=/path/to/tasks.json taskflow-mcp

MCP-Konfiguration

Um TaskFlow MCP mit KI-Assistenten zu verwenden, müssen Sie Ihren MCP-Client für die Verwendung des Servers konfigurieren. Erstellen Sie eine Datei mcp_config.json mit folgendem Inhalt:

{
  "mcpServers": {
    "taskflow": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/taskflow-mcp"],
      "env": {
        "TASK_MANAGER_FILE_PATH": "/path/to/tasks.json"
      }
    }
  }
}

🔄 Arbeitsablauf

TaskFlow MCP erzwingt einen bestimmten Arbeitsablauf:

Aufgaben planen : Eine Benutzeranfrage in Aufgaben aufteilen (mit optionalen Unteraufgaben)
Nächste Aufgabe abrufen : Rufen Sie die nächste ausstehende Aufgabe ab
Teilaufgaben abschließen : Wenn die Aufgabe Teilaufgaben hat, schließen Sie jede Teilaufgabe ab, bevor Sie die Aufgabe als erledigt markieren
Aufgabe als erledigt markieren : Markieren Sie eine Aufgabe als erledigt (erfordert, dass zuerst alle Unteraufgaben erledigt werden)
Auf Genehmigung warten : Warten Sie auf die Benutzergenehmigung der abgeschlossenen Aufgabe
Wiederholen : Fahren Sie mit der nächsten Aufgabe fort, bis alle Aufgaben abgeschlossen sind
Endgültige Genehmigung : Holen Sie die Benutzergenehmigung für die gesamte Anfrage ein

Damit KI-Assistenten diesen Arbeitsablauf konsequent befolgen, finden Sie in der Datei example-system-prompt.md Systemaufforderungen, die Sie den Anweisungen Ihres Assistenten hinzufügen können.

🧰 Verfügbare Tools

TaskFlow MCP stellt KI-Assistenten die folgenden Tools zur Verfügung:

`plan_task`

Registrieren Sie eine neue Benutzeranfrage und planen Sie die zugehörigen Aufgaben (mit optionalen Unteraufgaben).

{
  "originalRequest": "Create a new website for my business",
  "outputPath": "C:/Users/username/Documents/website-project-plan.md",
  "dependencies": [
    {
      "name": "Node.js",
      "version": ">=14.0.0",
      "description": "JavaScript runtime"
    },
    {
      "name": "npm",
      "version": ">=6.0.0",
      "description": "Package manager"
    }
  ],
  "notes": [
    {
      "title": "Package Manager Preference",
      "content": "User prefers pnpm over npm for package management."
    },
    {
      "title": "Design Guidelines",
      "content": "Follow the company's brand guidelines for colors and typography."
    }
  ],
  "tasks": [
    {
      "title": "Design homepage",
      "description": "Create a design for the homepage with logo, navigation, and hero section",
      "dependencies": [
        {
          "name": "Figma",
          "description": "Design tool"
        }
      ],
      "subtasks": [
        {
          "title": "Design logo",
          "description": "Create a logo that represents the business brand"
        },
        {
          "title": "Design navigation",
          "description": "Create a user-friendly navigation menu"
        }
      ]
    },
    {
      "title": "Implement HTML/CSS",
      "description": "Convert the design to HTML and CSS",
      "dependencies": [
        {
          "name": "HTML5",
          "description": "Markup language"
        },
        {
          "name": "CSS3",
          "description": "Styling language"
        }
      ]
    }
  ]
}

`get_next_task`

Rufen Sie die nächste ausstehende Aufgabe für eine Anfrage ab.

{
  "requestId": "req-1"
}

`mark_task_done`

Markieren Sie eine Aufgabe als erledigt.

{
  "requestId": "req-1",
  "taskId": "task-1",
  "completedDetails": "Created a modern design with a clean layout"
}

`approve_task_completion`

Genehmigen Sie eine abgeschlossene Aufgabe.

{
  "requestId": "req-1",
  "taskId": "task-1"
}

`approve_request_completion`

Genehmigen Sie eine gesamte Anfrage als abgeschlossen.

{
  "requestId": "req-1"
}

`open_task_details`

Erhalten Sie Details zu einer bestimmten Aufgabe.

{
  "taskId": "task-1"
}

`list_requests`

Listen Sie alle Anfragen im System auf.

{}

`add_tasks_to_request`

Fügen Sie einer bestehenden Anfrage weitere Aufgaben hinzu.

{
  "requestId": "req-1",
  "tasks": [
    {
      "title": "Add contact form",
      "description": "Create a contact form with validation"
    }
  ]
}

`update_task`

Aktualisieren Sie den Titel oder die Beschreibung einer Aufgabe.

{
  "requestId": "req-1",
  "taskId": "task-1",
  "title": "Design responsive homepage",
  "description": "Create a responsive design for the homepage"
}

`delete_task`

Löschen Sie eine Aufgabe aus einer Anfrage.

{
  "requestId": "req-1",
  "taskId": "task-1"
}

`add_subtasks`

Fügen Sie einer vorhandenen Aufgabe Unteraufgaben hinzu.

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtasks": [
    {
      "title": "Design logo",
      "description": "Create a logo that represents the business brand"
    },
    {
      "title": "Design navigation",
      "description": "Create a user-friendly navigation menu"
    }
  ]
}

`mark_subtask_done`

Markieren Sie eine Unteraufgabe als erledigt.

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtaskId": "subtask-1"
}

`update_subtask`

Aktualisieren Sie den Titel oder die Beschreibung einer Unteraufgabe.

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtaskId": "subtask-1",
  "title": "Design modern logo",
  "description": "Create a modern logo that represents the business brand"
}

`delete_subtask`

Löschen Sie eine Unteraufgabe aus einer Aufgabe.

{
  "requestId": "req-1",
  "taskId": "task-1",
  "subtaskId": "subtask-1"
}

`export_task_status`

Exportieren Sie den aktuellen Status aller Aufgaben einer Anfrage in eine Datei. Für eine zuverlässigere Dateierstellung wird die Verwendung absoluter Pfade empfohlen.

{
  "requestId": "req-1",
  "outputPath": "C:/Users/username/Documents/task-status.md",
  "format": "markdown"
}

`add_note`

Fügen Sie einer Anfrage eine Notiz hinzu.

{
  "requestId": "req-1",
  "title": "Package Manager Preference",
  "content": "User prefers pnpm over npm for package management."
}

`update_note`

Aktualisieren Sie eine vorhandene Notiz.

{
  "requestId": "req-1",
  "noteId": "note-1",
  "title": "Package Manager Preference",
  "content": "User prefers pnpm over npm and yarn for package management."
}

`delete_note`

Löschen Sie eine Notiz aus einer Anfrage.

{
  "requestId": "req-1",
  "noteId": "note-1"
}

`add_dependency`

Fügen Sie einer Anfrage oder Aufgabe eine Abhängigkeit hinzu.

{
  "requestId": "req-1",
  "taskId": "task-1",
  "dependency": {
    "name": "react",
    "version": "^18.2.0",
    "description": "JavaScript library for building user interfaces",
    "url": "https://reactjs.org"
  }
}

📚 Dokumentation

Ausführlichere Informationen zur Projektarchitektur und -implementierung finden Sie in der Datei OVERVIEW.md .

📝 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

🤝 Beitragen

Beiträge sind willkommen! Richtlinien finden Sie in der Datei CONTRIBUTING.md .

📜 Änderungsprotokoll

Einen Verlauf der Änderungen an diesem Projekt finden Sie in der Datei CHANGELOG.md .

🙏 Danksagungen

Erstellt mit Model Context Protocol (MCP)
Erstellt von Pink Pixel

Hergestellt mit ❤️ von Pink Pixel

Integrations

TaskFlow MCP 🔄✅

🌟 Übersicht

✨ Funktionen

🚀 Installation

Globale Installation

Lokale Installation

🛠️ Verwendung

Starten des Servers

Konfiguration

MCP-Konfiguration

🔄 Arbeitsablauf

🧰 Verfügbare Tools

plan_task

get_next_task

mark_task_done

approve_task_completion

approve_request_completion

open_task_details

list_requests

add_tasks_to_request

update_task

delete_task

add_subtasks

mark_subtask_done

update_subtask

delete_subtask

export_task_status

add_note

update_note

delete_note

add_dependency