使用说明
代理TODO MCP服务器
现在所有的编辑都有这个功能，所以是的。..
用于AI代理管理任务和跟踪项目进度的模型上下文协议服务器。
特性
- 使用详细的元数据创建、更新和管理TODO
- 跟踪进度、状态、优先级和依赖关系
- 明确的项目隔离 防止工作区之间的数据混淆
- 搜索、筛选并生成全面的报告
- 具有完全项目分离的持久JSON存储
安装
通过npm（推荐）
npm install -g agent-todo-mcp
来源
git clone https://github.com/w04m1/agent-todo-mcp.git
cd agent-todo-mcp
npm install
npm run build
npm install -g .
配置
添加到您的Claude桌面/光标/VCode/等配置中：
{
"mcpServers": {
"agent-todo": {
"command": "agent-todo-mcp"
}
}
}
AI模型如何使用此服务器
当AI模型与此MCP服务器交互时，它们遵循以下工作流程：
- 检查现有项目 随着
list_projects - 创建或切换到项目 随着
switch_project - 创建和管理TODO 在该项目工作空间内
项目管理
项目命名最佳实践
创建项目时，使用描述性名称，明确标识工作空间：
- ✅
"my-react-app"-良好的描述性名称 - ✅
"backend-api-v2"-清除项目标识符 - ✅
"research-ml-models"-描述性和具体性 - ❌
"project1"-过于笼统 - ❌
"temp"-非描述性
项目隔离和储存
每个项目工作区都是完全隔离的。TODO存储在：
~/.agent-todos/
├── my-react-app/todos.json # Project: "my-react-app"
├── backend-api-v2/todos.json # Project: "backend-api-v2"
├── research-ml-models/todos.json # Project: "research-ml-models"
└── default-workspace/todos.json # Default fallback project
建筑
- 完全隔离：每个项目都有自己的TODO存储
- 显性管理：项目是通过以下方式显式创建的
switch_project工具 - 永久存储：所有数据都保存在
~/.agent-todos/{projectId}/ - ⚠️ 无删除：无法通过API删除项目（只能删除单个TODO）
可用工具
项目管理
list_projects-列出所有可用的项目工作区switch_project-创建新项目或在现有项目之间切换get_project_info-显示当前项目详细信息
核心管理层
create_todo-创建新任务update_todo-更新现有任务delete_todo-删除任务list_todos-列出和筛选任务get_todo-获取详细的任务信息
搜索和分析
search_todos-搜索所有任务generate_report-创建进度报告get_stats-快速统计
TODO结构
interface Todo {
id: string;
title: string;
description?: string;
status: "pending" | "in-progress" | "completed" | "blocked";
priority: "low" | "medium" | "high" | "urgent";
progress: number; // 0-100
tags: string[];
dependencies: string[]; // Other TODO IDs
dueDate?: string;
metadata: Record<string, any>;
createdAt: string;
updatedAt: string;
}
发展
npm run dev # Development mode
npm run build # Build project
npm start # Run built server
许可证
麻省理工学院
