基于 MCP 协议的智能需求链化管理系统
| 核心功能 | 说明 |
|---|---|
| 需求分解 | 智能分解复杂需求为可执行的子需求 |
| 依赖管理 | 自动检测和管理需求间的依赖关系 |
| 链化构建 | 基于依赖关系构建最优执行链 |
| 并行处理 | 识别并行需求，支持自定义执行顺序 |
| 状态追踪 | 实时追踪项目执行进度和状态 |
| 快照回滚 | 支持项目状态快照和回滚功能 |
| 并发控制 | 项目锁定机制防止并发冲突 |
| 验证管理 | 为叶子节点添加测试用例和验收标准 |
| 高级特性 | 说明 |
|---|---|
| MCP 协议 | 基于 Model Context Protocol 的标准化接口 (8个合并工具) |
| 图数据库 | real-ladybug 图数据库存储,支持复杂依赖关系 |
| 依赖注入 | dependency-injector 容器管理服务生命周期 |
| 速率限制 | 内置请求限流保护,防止滥用 |
| CLI 工具 | 完整的命令行界面 (Typer) |
| HTTP API | 内置 HTTP 服务器,提供健康检查和性能指标 |
| API 版本管理 | 版本查询和兼容性管理 |
| 跨平台 | Python 实现,支持多平台部署 |
| 工具名称 | 说明 | 操作类型 |
|---|---|---|
| manage_project | 项目管理 | get, create, update |
| manage_requirement | 需求管理 | get, create, update, delete, mark_leaf, list |
| manage_dependency | 依赖管理 | 添加单个依赖 / 批量传递依赖 |
| manage_validation | 验证管理 | 添加验证 / 执行验证 |
| manage_execution | 执行流程管理 | next, complete, state, trigger |
| manage_snapshot | 快照管理 | create, restore, list |
| manage_lock | 锁管理 | acquire, release, check, info |
| get_api_version | API 版本查询 | - |
# 克隆仓库
git clone https://github.com/Kirky-X/axon.git
cd axon
# 方式一: 使用安装脚本(推荐)
bash scripts/install.sh
# 方式二: 手动安装
uv venv
source .venv/bin/activate # Linux/Mac
# .venv\Scripts\activate # Windows
# 安装项目(包含开发依赖)
uv pip install -e .[dev]# 设置数据库路径 (可选)
export MCP_AXON_DB_PATH="my_custom.db"# 项目管理
axon project create --name "我的项目" --desc "项目描述"
axon project get <project_id>
axon project update <project_id> --name "新名称"
# 需求管理
axon requirement create --project <project_id> --content "实现用户认证"
axon requirement get <requirement_id>
axon requirement list --project <project_id>
axon requirement update <requirement_id> --status "completed"
axon requirement delete <requirement_id>
axon requirement mark-leaf <requirement_id>
# 依赖管理
axon dependency add <requirement_id> <dependency_id>
axon dependency transfer <parent_id> --mapping '{"child_id": ["dep_id"]}'
# 验证管理
axon validation add <requirement_id> --tests '[{"name": "测试1", "steps": [], "expected_result": "通过"}]'
axon validation run <requirement_id>
# 执行管理
axon execution next --project <project_id>
axon execution complete <requirement_id> --project <project_id>
axon execution state --project <project_id>
# 快照管理
axon snapshot create --project <project_id>
axon snapshot restore <snapshot_id>
axon snapshot list --project <project_id>
# 锁管理
axon lock acquire --project <project_id>
axon lock release --project <project_id>
axon lock check --project <project_id>
# 版本查询
axon version# 启动 MCP 服务器 (stdio 模式,默认)
axon-server
# 启动 HTTP 服务器
axon-server --mode http --http-port 8080
# 同时启动 MCP 和 HTTP 服务器
axon-server --mode both --http-host 0.0.0.0 --http-port 8080
# 指定数据库路径
axon-server --db-path my_project.db --mode httpHTTP 服务器端点:
| 端点 | 说明 |
|---|---|
/ |
API 信息 |
/health |
健康检查 |
/metrics |
性能指标 |
/api_version |
API 版本信息 |
axon-server 参数:
| 参数 | 默认值 | 说明 |
|---|---|---|
--mode |
mcp |
运行模式: mcp, http, both |
--db-path |
axon.db |
数据库文件路径 |
--http-host |
0.0.0.0 |
HTTP 服务器绑定地址 |
--http-port |
8080 |
HTTP 服务器端口 |
在 Claude Desktop 或其他 MCP 客户端中使用以下配置：
{
"mcpServers": {
"axon": {
"command": "uv",
"args": [
"run",
"--isolated",
"--with",
"git+https://github.com/Kirky-X/axon.git",
"axon"
]
}
}
}注意: MCP 客户端通过
axon命令连接到 MCP 服务器 (stdio 模式)。
| 文档 | 说明 |
|---|---|
| 用户指南 | 完整使用指南 |
| API 参考 | MCP 工具完整文档 (8个合并工具) |
| 架构设计 | 系统架构设计 |
| 常见问题 | 常见问题解答 |
| 贡献指南 | 贡献代码指南 |
| 缓存配置 | 缓存配置说明 |
# 运行所有测试
uv run pytest tests/ -v --cov=src
# 运行性能测试
uv run pytest tests/performance/ -v
# 运行端到端测试
uv run pytest tests/test_e2e/ -v
# 运行预检查(包含测试)
bash scripts/pre-commit-check.sh测试配置 (pyproject.toml):
- 测试路径:
tests/ - 异步模式:
auto - 缓存目录:
/tmp/pytest_cache_mcp_axon - 自动禁用字节码生成和 benchmark
测试结果: 所有测试通过 ✅
| 操作 | 性能要求 | 实测结果 |
|---|---|---|
| CRUD 操作 | < 50ms | 1.06ms ✅ |
| 拓扑排序 (2000 节点) | < 1000ms | 2.82ms ✅ |
| 全量链化 (2000 节点) | < 2000ms | 92.58ms ✅ |
欢迎贡献代码、文档或报告问题！
- Fork 本仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
本项目基于 MIT 许可证开源。