任务十字军MCP
\[！警告\] 此项目不再维护。 我最初创建Task Crusader是为了解决跟踪人工智能辅助开发中长时间运行的任务和项目列表的问题。从那时起，大多数主要的人工智能编码代理都添加了强大的内置任务管理，这个项目在实践中不再特别有用。
您的AI编码助手的任务伙伴-通过MCP进行活动和任务管理。
概述
Task Crusader是一个为AI编码助手设计的战役和任务管理系统。它提供了一个模型上下文协议（MCP）服务器，使Claude、Cursor等AI代理能够将工作组织成活动（项目）和任务，包括：
- 依赖追踪：任务可以依赖于其他任务
- 验收标准：定义每项任务的完成要求
- 测试策略：任务的文档验证方法
- 研究与笔记：收集调查结果和实施细节
- 进度监控：跟踪活动进度并找到可操作的任务
- 质量提示：活动设置和执行的上下文感知指导
- 顺序和并行执行：支持单代理和多代理工作流
安装
pip install task-crusader-mcp默认情况下，Task Crusader会安装所有功能：
- MCP服务器：人工智能助理的核心活动/任务管理（63个工具）
- 命令行界面：命令行界面(
crusader命令） - 文本用户界面：终端用户界面(
crusader-tui命令）
需要最少安装的高级用户可以使用 pip install --no-deps task-crusader-mcp 并手动指定依赖关系。
快速开始
1.配置您的AI助手
添加到您的MCP客户端配置中（例如，Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"task-crusade": {
"command": "crusader-mcp"
}
}
}或光标(.cursor/mcp.json):
{
"mcpServers": {
"task-crusade": {
"command": "crusader-mcp"
}
}
}2.基本工作流程
- 创建活动：
campaign_create(name="My Project")- 添加任务：
task_create(title="Implement feature", campaign_id="...")- 添加验收标准：
task_acceptance_criteria_add(task_id="...", content="Unit tests pass")- 添加测试策略：
task_testing_strategy_add(task_id="...", content="Run pytest with coverage")- 执行任务循环：
while campaign not complete:
1. campaign_get_next_actionable_task(campaign_id) -> get next task
2. task_update(task_id, status="in-progress") -> claim task
3. [Implement the task]
4. task_acceptance_criteria_mark_met(criteria_id) -> mark criteria met
5. task_complete(task_id) -> complete task3.批量活动创建（推荐）
对于新项目，请使用 campaign_create_with_tasks 以原子方式创建一切：
campaign_create_with_tasks(campaign_json='{
"campaign": {"name": "Auth System", "priority": "high"},
"tasks": [
{"temp_id": "setup", "title": "Setup environment", "acceptance_criteria": ["Dev server runs"]},
{"temp_id": "impl", "title": "Implement login", "dependencies": ["setup"]},
{"temp_id": "test", "title": "Integration tests", "dependencies": ["impl"]}
]
}')可用工具（共63个）
活动管理（21个工具）
| 类别 | 工具 |
|---|---|
| 核心CRUD | campaign_create, campaign_list, campaign_show, campaign_update, campaign_delete |
| 进展与行动 | campaign_get_progress_summary, campaign_get_next_actionable_task, campaign_get_all_actionable_tasks, campaign_overview, campaign_details |
| 批量和工作流 | campaign_create_with_tasks, campaign_validate_readiness, campaign_workflow_guide, campaign_get_state_snapshot, campaign_renumber_tasks |
| 研究 | campaign_research_add, campaign_research_list, campaign_research_show, campaign_research_update, campaign_research_delete, campaign_research_reorder |
任务管理（42个工具）
| 类别 | 工具 |
|---|---|
| 核心CRUD | task_create, task_list, task_show, task_update, task_delete, task_complete |
| 验收标准 | task_acceptance_criteria_add, task_acceptance_criteria_mark_met, task_acceptance_criteria_mark_unmet, task_acceptance_criteria_list, task_acceptance_criteria_show, task_acceptance_criteria_update, task_acceptance_criteria_delete, task_acceptance_criteria_reorder |
| 测试策略 | task_testing_strategy_add, task_testing_strategy_list, task_testing_strategy_show, task_testing_strategy_update, task_testing_strategy_delete, task_testing_strategy_mark_passed, task_testing_strategy_mark_failed, task_testing_strategy_mark_skipped, task_testing_strategy_reorder, task_testing_step_add |
| 研究 | task_research_add, task_research_list, task_research_show, task_research_update, task_research_delete, task_research_reorder |
| 实现注意事项 | task_implementation_notes_add, task_implementation_notes_list, task_implementation_notes_show, task_implementation_notes_update, task_implementation_notes_delete, task_implementation_notes_reorder |
| 搜索和分析 | task_search, task_stats, task_get_dependency_info |
| 批量和工作流 | task_bulk_update, task_create_from_template, task_complete_with_workflow |
命令行用法
# Create a campaign
crusader campaign create "My Project" --description "My awesome project"
# List campaigns
crusader campaign list
# Show campaign details
crusader campaign show
# Create a task
crusader task create "Implement feature" --campaign
# Show task details
crusader task show
# Update task status
crusader task update --status in-progressTUI使用
crusader-tui这将打开一个交互式终端界面，用于通过键盘导航、过滤和批量操作浏览活动和任务。
数据库
默认情况下，Task Crusader将数据存储在 ~/.crusader/database.db。您可以通过设置来配置自定义路径 CRUSADER_DB_PATH 环境变量。
建筑
任务十字军遵循干净的六边形架构：
MCP Server → Service Layer → Repository Layer → SQLite Database
↓
Domain Layer (DTOs, Result Types, Hints)关键设计决策：
- 直接服务电话：MCP工具直接调用服务（无CLI子流程开销）
- 结果模式：所有操作返回
DomainResult用于显式错误处理 - 上下文感知提示：操作返回下一步操作的指导提示
- 内存系统内部：验收标准、研究、笔记和测试步骤使用内部存储系统
贡献
欢迎投稿！在推送之前，请在本地运行CI检查：
./scripts/check_ci.sh这运行：
- 用Linting
ruff check src/ tests/ - 覆盖范围测试：
pytest --cov --cov-fail-under=65 - 可选类型检查：
mypy src/
看 贡献.md 详细指南。
许可证
MIT许可证-有关详细信息，请参阅许可证文件。