ZihTasks MCP服务器
模型上下文协议 (MCP) 服务器,用于管理 AI 代理的部署任务。
🎯 概念
该MCP允许LLM在部署功能之前以结构化方式创建和管理任务。每个任务都有自己的 隔离的背景 (类似于单独的“标签”),具有运行历史记录,日志和依赖关系。
🚀 安装```bash
Clone ou navegue até o diretório
cd d:\Projects\MCP\zihtasks-mcp
Instale as dependências
bun install
Compile o TypeScript
bun run build
## ⚙️ 配置
### 选项 1: Claude Desktop
添加到您的 `claude_desktop_config.json`:```json
{
"mcpServers": {
"zihtasks": {
"command": "node",
"args": ["d:/Projects/MCP/zihtasks-mcp/build/index.js"]
}
}
}
文件位置 :
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - Mac/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json
设置完成后, 重新启动 Claude Desktop 。
📖 完整指南: 查看 TESTING.md 详细的指示。
选项 2:Gemini CLI
添加到您的 mcp_config.json:```json
{
"mcpServers": {
"zihtasks": {
"command": "node",
"args": ["d:/Projects/MCP/zihtasks-mcp/build/index.js"],
"env": {}
}
}
}
**文件位置 :**
- **窗户:** `%USERPROFILE%\.gemini\mcp_config.json`
- **Mac/Linux:** `~/.gemini/mcp_config.json`
配置后, 启动 Gemini CLI `gemini-cli`.
📖 **完整指南:** 查看 `GEMINI_CLI.md` 详细的指示。
## 📋 可用工具
### 1. `create_project`
创建一个新工程来组织任务 。```json
{
"name": "Implementar Sistema de Login",
"description": "Sistema completo de autenticação com JWT"
}
2. create_task
在工程中创建新任务 。```json
{
"projectId": "1234-abc",
"title": "Criar schema do banco de dados",
"description": "Definir tabelas users, sessions, tokens",
"dependencies": [],
"metadata": {
"priority": "high",
"estimate": "2h"
}
}
### 3. `update_task_status`
更新任务的状态 。
可用状态 : `pending` → `in_progress` → `completed` (ou `blocked`)```json
{
"projectId": "1234-abc",
"taskId": "5678-def",
"status": "in_progress"
}
4. add_task_context
向任务的上下文/历史记录添加信息。```json
{
"projectId": "1234-abc",
"taskId": "5678-def",
"context": "Implementado validação de email. Testes passando."
}
### 5. `list_tasks`
列出工程中的所有任务 。```json
{
"projectId": "1234-abc",
"status": "all" // ou "pending", "in_progress", "completed"
}
6. get_task_details
获取特定任务的所有详细信息和历史记录。```json
{
"projectId": "1234-abc",
"taskId": "5678-def"
}
### 7. `get_next_task`
返回下一个可执行的待办任务( 没有锁定的依赖关系) 。```json
{
"projectId": "1234-abc"
}
💡 使用示例(LLM工作流程)```
Usuário: "Crie um sistema de autenticação JWT"
LLM: Vou criar um projeto e quebrar isso em tasks:
- [create_project] → ID: proj-123
- [create_task] "Criar schema do banco" → ID: task-1
- [create_task] "Implementar registro de usuário" → ID: task-2 (depende de task-1)
- [create_task] "Implementar login e JWT" → ID: task-3 (depende de task-2)
-
[create_task] "Adicionar middleware de autenticação" → ID: task-4 (depende de task-3)
-
[get_next_task] → Retorna task-1 (sem dependências)
- [update_task_status] task-1 → "in_progress"
- [add_task_context] "Criado schema com tabelas users, sessions"
- ... implementa o código ...
-
[update_task_status] task-1 → "completed"
-
[get_next_task] → Retorna task-2 (task-1 já está completa)
- Repete o processo...
## 🔄 特殊资源
### 按任务隔离的上下文
每个任务都有自己的数组。 `context[]` 它作为一个孤立的“聊天”:
- 进展日志
- 实施过程中的发现
- 找到的问题
- 作出的决定
### 依赖系统
任务可能依赖于其他任务。系统自动:
- 阻止有未完成依赖关系的任务
- `get_next_task` 总是只返回可执行任务
### MCP 资源
所有项目和任务都显示为 MCP 资源:
- `task://project/{projectId}` 查看完整项目
- `task://project/{projectId}/task/{taskId}` -可视化任务专用
## 🎨 自定义
您可以添加更多字段到 `metadata` das任务:
- 优先级
- 时间估计
- 标签
- 负责人
- Tipo de task(后端、前端、文档等)
## 📝 注释
- 数据存储在内存中(重新启动服务器将清除数据)
- 为了持久性,您可以添加保存到JSON文件或数据库
- 系统同时支持多个项目
## 🛠️ 开发```bash
# Modo watch (recompila automaticamente)
bun run watch
# Em outro terminal, teste
bun start
🚀 下一步
- ✅ 完整的基本实施
- 🔜 向文件/银行添加持久性
- 🔜 添加常见任务模板
- 🔜 添加统计和报告
- 🔜 添加高级搜索/过滤器
- 🔜 添加对子任务的支持
📦 可用脚本
bun run build-编译TypeScriptbun run watch以 watch 模式编译bun start- 运行编译的服务器bun run dev编译和运行(快速开发)
