TaskFlow MCP

TaskFlow MCP 🔄✅

Сервер протокола контекста модели управления задачами (MCP) для планирования и выполнения задач с помощью помощников на основе искусственного интеллекта.

🌟 Обзор

TaskFlow MCP — специализированный сервер, который помогает помощникам ИИ разбивать запросы пользователей на управляемые задачи и отслеживать их выполнение. Он обеспечивает структурированный рабочий процесс с шагами одобрения пользователя, чтобы гарантировать, что задачи отслеживаются должным образом, а пользователи сохраняют контроль над процессом.

✨ Особенности

📋 Планирование задач : разбейте сложные запросы на выполнимые задачи
🔍 Подзадачи : разделите задачи на более мелкие и более управляемые подзадачи.
📊 Отслеживание прогресса : отслеживайте статус задач, подзадач и запросов с помощью визуальных таблиц прогресса.
👍 Одобрение пользователя : Обеспечьте выполнение шагов одобрения пользователя для обеспечения качества и контроля.
💾 Сохранение : сохранение задач и запросов на диске для сохранения между сеансами.
🔄 Гибкое управление : добавляйте, обновляйте или удаляйте задачи и подзадачи по мере необходимости.
📝 Подробная отчетность : просмотр подробностей задач и таблиц прогресса
📤 Параметры экспорта : экспортируйте планы задач и отчеты о статусе в форматах Markdown, JSON или HTML.
📦 Зависимости : отслеживайте зависимости на уровне проекта и задачи с информацией о версии
📌 Заметки : добавляйте заметки на уровне проекта для важной информации и предпочтений.

🚀 Установка

Глобальная установка

npm install -g @pinkpixel/taskflow-mcp

Локальная установка

npm install @pinkpixel/taskflow-mcp

🛠️ Использование

Запуск сервера

При глобальной установке:

taskflow-mcp

При локальной установке:

npx taskflow-mcp

Конфигурация

По умолчанию TaskFlow MCP сохраняет задачи в ~/Documents/tasks.json . Вы можете изменить это, установив переменную среды TASK_MANAGER_FILE_PATH :

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

Конфигурация МКП

Чтобы использовать TaskFlow MCP с помощниками AI, вам необходимо настроить клиент MCP для использования сервера. Создайте файл mcp_config.json со следующим содержимым:

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

🔄 Рабочий процесс

TaskFlow MCP обеспечивает определенный рабочий процесс:

Планирование задач : разбейте запрос пользователя на задачи (с дополнительными подзадачами).
Получить следующую задачу : получить следующую отложенную задачу
Завершите подзадачи : если у задачи есть подзадачи, завершите каждую подзадачу, прежде чем отмечать задачу как выполненную.
Отметить задачу как выполненную : отметить задачу как выполненную (требуется сначала выполнить все подзадачи)
Ожидание одобрения : Ожидание одобрения пользователем выполненной задачи.
Повторить : продолжить выполнение следующей задачи, пока все задачи не будут выполнены.
Окончательное одобрение : получите одобрение пользователя на весь запрос.

Чтобы помощники на основе искусственного интеллекта могли последовательно следовать этому рабочему процессу, ознакомьтесь с файлом example-system-prompt.md, в котором приведены системные подсказки, которые вы можете добавить к инструкциям помощника.

🧰 Доступные инструменты

TaskFlow MCP предоставляет следующие инструменты помощникам на базе искусственного интеллекта:

`plan_task`

Зарегистрируйте новый запрос пользователя и запланируйте связанные с ним задачи (с дополнительными подзадачами).

{
  "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`

Получить следующую ожидающую задачу для запроса.

{
  "requestId": "req-1"
}

`mark_task_done`

Отметить задачу как выполненную.

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

`approve_task_completion`

Одобрить выполненную задачу.

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

`approve_request_completion`

Утвердить весь запрос как выполненный.

{
  "requestId": "req-1"
}

`open_task_details`

Получите подробную информацию о конкретной задаче.

{
  "taskId": "task-1"
}

`list_requests`

Список всех запросов в системе.

{}

`add_tasks_to_request`

Добавьте больше задач к существующему запросу.

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

`update_task`

Обновите название или описание задачи.

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

`delete_task`

Удалить задачу из запроса.

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

`add_subtasks`

Добавить подзадачи к существующей задаче.

{
  "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`

Отметить подзадачу как выполненную.

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

`update_subtask`

Обновите название или описание подзадачи.

{
  "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`

Удалить подзадачу из задачи.

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

`export_task_status`

Экспортировать текущий статус всех задач в запросе в файл. Рекомендуется использовать абсолютные пути для более надежного создания файла.

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

`add_note`

Добавьте примечание к запросу.

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

`update_note`

Обновить существующую заметку.

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

`delete_note`

Удалить заметку из запроса.

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

`add_dependency`

Добавьте зависимость к запросу или задаче.

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

📚 Документация

Более подробную информацию об архитектуре проекта и его реализации смотрите в файле OVERVIEW.md .

📝 Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

🤝 Вклад

Вклады приветствуются! Пожалуйста, смотрите файл CONTRIBUTING.md для инструкций.

📜 Журнал изменений

Историю изменений в этом проекте смотрите в файле CHANGELOG.md .

🙏 Благодарности

Создано с использованием протокола контекста модели (MCP)
Создано Pink Pixel

Сделано с ❤️ Pink Pixel

Integrations

TaskFlow MCP 🔄✅

🌟 Обзор

✨ Особенности

🚀 Установка

Глобальная установка

Локальная установка

🛠️ Использование

Запуск сервера

Конфигурация

Конфигурация МКП

🔄 Рабочий процесс

🧰 Доступные инструменты

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