tasktrekmcp (Cskoushik9)

TaskTrek MCP服务器

TaskTrek项目管理系统的模型上下文协议（MCP）服务器，使AI助手能够以编程方式与TaskTrek交互。

相关项目

• TaskTrek Web应用程序:
• TaskTrek MCP服务器:

架构流程

┌─────────────────────┐    ┌──────────────────────┐    ┌─────────────────────┐
│   AI Assistant      │◄──►│   TaskTrek MCP       │◄──►│   JSON Files        │
│   (Claude, Cline)   │    │   Server (stdio)     │    │   (Data Storage)    │
└─────────────────────┘    └──────────────────────┘    └─────────────────────┘
                                      ▲                           ▲
                                      │                           │
                                      ▼                           ▼
                           ┌──────────────────────┐    ┌─────────────────────┐
                           │   MCP Tools          │    │   TaskTrek Web App  │
                           │   • create_task      │    │   (React Frontend)  │
                           │   • update_task      │    │   • Visual Interface│
                           │   • list_tasks       │    │   • Manual Editing  │
                           │   • summarize_tasks  │    │   • Analytics       │
                           │   • create_project   │    │   • Project Mgmt    │
                           │   • list_projects    │    └─────────────────────┘
                           │   • get_task         │
                           └──────────────────────┘

数据流：

1. AI助手 通过MCP协议发送命令
2. MCP服务器 处理请求并更新JSON文件
3. 网页应用 从相同的JSON文件读取可视化界面
4. 双向同步 -任一界面中的更改都会持续

使用模式：

• AI优先：使用MCP服务器进行自动化任务管理
• 视觉优先：使用web应用程序进行手动任务管理
• 混合：根据需要在两者之间切换-数据保持同步

特性

TaskTrek MCP服务器提供以下工具：

1. create_task

使用以下参数在TaskTrek中创建新任务：

• title （必填）：任务标题
• description：任务描述
• projectId：项目ID（默认为“默认”）
• type：任务类型（错误、功能、增强）
• priority：任务优先级（低、中、高、关键）
• componentId：组件ID
• assigneeId：受让人ID
• labels：任务标签数组

2. create_project

使用以下内容创建新项目：

• name （必填）：项目名称
• key （必填）：项目密钥（例如“PROJ”）
• description：项目描述

3. update_task

更新现有任务：

• taskId （必填）：要更新的任务ID
• title：新任务标题
• description：新任务描述
• status：新任务状态（屏幕、进行中、代码审查、代码完成、质量保证验证、已解决）
• priority：新任务优先级
• componentId：新组件ID
• assigneeId：新受让人ID
• labels：新任务标签

4. list_projects

获取所有可用项目的列表。

5. list_tasks

使用可选筛选获取所有任务的列表：

• projectId：按项目ID筛选
• status：按状态筛选
• assigneeId：按受让人ID筛选

6. get_task

获取特定任务的详细信息：

• taskId （必填）：要检索的任务ID

7. summarize_tasks

获取带有统计信息的任务摘要：

• projectId：按项目ID筛选（可选）

先决条件

1. Node.js （v14或更高版本）
2. npm 或 纱线
3. TaskTrek Web应用程序 （可选，用于可视化界面）

安装

1. 克隆存储库：

git clone https://github.com/CsKoushik9/TaskTrekMCP.git
cd TaskTrekMCP

1. 安装依赖项：

npm install

1. 验证服务器是否正常运行：

npm start

VS代码集成设置

有关VS Code与Cline扩展的详细集成，请参阅 vscode-genai-setup.md 该文件提供：

• 逐步安装Cline扩展
• VS代码的MCP服务器配置
• 克劳德桌面替代设置
• 测试命令和故障排除

快速VS代码设置

1. 安装 克莱恩 VS代码中的扩展
2. 在Cline设置中配置MCP服务器：

{
  "mcpServers": {
    "tasktrek": {
      "command": "node",
      "args": ["index.js"],
      "cwd": "/path/to/TaskTrekMCP"
    }
  }
}

1. 启动MCP服务器： npm start
2. 在Cline聊天中使用“列出所有项目”进行测试

用法

运行服务器

npm start

发展模式

npm run dev

数据存储和同步

MCP服务器将数据存储在JSON文件中 ../TaskTrek/data/ 目录：

• tasks.json：所有任务
• projects.json：所有项目
• components.json：所有组件
• assignees.json：所有受让人

同步行为：

• MCP服务器：直接写入JSON文件
• 网页应用：启动时从JSON文件读取
• 无冲突：两个接口都可以独立使用
• 数据持久层：在任一界面中所做的更改都将保持不变

运行两个接口：

# Terminal 1: Start MCP Server (for AI assistant)
cd TaskTrekMCP
npm start

# Terminal 2: Start Web App (for visual interface) - OPTIONAL
cd TaskTrek
npm start

备注：你不需要同时运行这两个。根据您的工作流程进行选择：

• 仅限AI：只需运行MCP服务器
• 仅视觉：只需运行web应用程序
• 混合：运行两者并根据需要进行切换

与MCP客户端集成

此服务器可以与任何兼容MCP的客户端集成。服务器通过stdio进行通信，并为所有操作提供结构化响应。

示例用法

创建任务

{
  "tool": "create_task",
  "arguments": {
    "title": "Fix login bug",
    "description": "Users cannot login with special characters in password",
    "type": "bug",
    "priority": "high",
    "projectId": "default"
  }
}

更新任务状态

{
  "tool": "update_task",
  "arguments": {
    "taskId": "1234567890",
    "status": "in-progress"
  }
}

获取任务摘要

{
  "tool": "summarize_tasks",
  "arguments": {
    "projectId": "default"
  }
}

错误处理

服务器为以下对象提供详细的错误消息：

• 任务/项目ID无效
• 缺少必要参数
• 验证错误
• 文件系统错误

许可证

MIT许可证