使用说明
易利达
用于项目管理自动化的MCP服务器
安装
🚨 开发：本项目使用 uv 用于所有包管理。看 .cursorrules 了解详情。
使用 uv （推荐-更快）：
# For end users installing from PyPI
uv pip install exarp
# For developers working on this repo
uv sync
使用 pip （回退-不建议用于开发）：
pip install exarp
快速开始
# Run the MCP server
exarp
# Or use aliases
pma
python -m project_management_automation.server
MCP客户端配置
添加到您的MCP客户端配置（光标、克劳德桌面、VS代码）：
{
"mcpServers": {
"exarp": {
"command": "/path/to/project-management-automation/exarp-uvx-wrapper.sh",
"args": ["--mcp"]
}
}
}
推荐：使用 exarp-uvx-wrapper.sh 自动检测 uvx 跨平台定位（Ubuntu、macOS英特尔/苹果硅）。
替代：如果 uvx 如果在PATH中，请直接使用：
{
"mcpServers": {
"exarp": {
"command": "uvx",
"args": ["exarp", "--mcp"]
}
}
}
看 UVX定位指南 了解详细的平台特定说明。
发展
保持MCP功能同步
此项目支持FastMCP和stdio服务器接口。添加工具、资源或提示时，必须在中注册它们 两者 系统。
📖 看 MCP同步指南 获取完整说明。
快速检查：
uv run python scripts/verify_mcp_sync.py
特性
🏥 项目健康
| 工具 | 说明 |
|---|---|
server_status |
服务器状态、版本、工具计数 |
project_scorecard |
全面的健康指标（代码库、测试、任务、文档、安全性） |
project_overview |
单页摘要（文本、标记、HTML、幻灯片） |
📚 文档
| 工具 | 说明 |
|---|---|
check_documentation_health |
分析文档，查找断开的链接，验证格式 |
add_external_tool_hints |
在文档中添加Context7提示 |
✅ 任务管理
| 工具 | 说明 |
|---|---|
analyze_todo2_alignment |
检查任务与PROJECT_GOALS.md的对齐情况 |
detect_duplicate_tasks |
查找并合并重复任务 |
consolidate_tags |
标准化任务标签 |
task_hierarchy_analyzer |
推荐任务层次结构 |
batch_approve_tasks |
批量批准任务，无需澄清 |
sync_todo_tasks |
TODO表和Todo2之间的同步 |
🔒 安全
| 工具 | 说明 |
|---|---|
scan_dependency_security |
扫描Python/Rust/NMP以查找漏洞 |
🤖 自动化
| 工具 | 说明 |
|---|---|
run_daily_automation |
日常维护（文档、对齐、副本） |
run_nightly_task_automation |
并行执行后台任务 |
sprint_automation |
包含子任务提取的完整冲刺 |
find_automation_opportunities |
发现自动化候选人 |
🔧 CI/CD和Git
| 工具 | 说明 |
|---|---|
validate_ci_cd_workflow |
验证GitHub操作工作流 |
setup_git_hooks |
配置预提交/预推挂钩 |
setup_pattern_triggers |
文件/git/任务模式自动化 |
check_working_copy_health |
跨代理的Git状态 |
🧪 测试
| 工具 | 说明 |
|---|---|
run_tests |
执行pytest/unittest/ctest |
analyze_test_coverage |
覆盖率报告和差距分析 |
ZSH插件
对于与上下文感知项目健康状况的shell集成：
# Add to ~/.zshrc
source /path/to/exarp.plugin.zsh
# Commands
xl # Quick context (no Python needed)
xc # Full context with score
xs # Project scorecard
xo # Project overview
xt # List pending tasks
xp # Scan for projects
motd # Daily wisdom
看 shell/exarp.plugin.zsh 获取完整文档。
日常智慧
Exarp包括基于项目健康状况的可选每日智慧语录：
# Configure source
export EXARP_WISDOM_SOURCE=stoic # or: bofh, tao, bible, murphy, shakespeare, sefaria
# Disable
export EXARP_WISDOM_DISABLED=1
手册页
man exarp # MCP server documentation
man exarp-zsh # ZSH plugin documentation
需求
- Python 3.9+
- FastMCP 2.0+
- Pydantic 2.0+
链接
- PyPI: https://pypi.org/project/exarp/
- GitHub: https://github.com/davidl71/project-management-automation
- 问题: https://github.com/davidl71/project-management-automation/issues
许可证
MIT许可证-请参阅 许可证
归因
该项目包括受第三方项目启发的功能：
所有实现都是原始代码。没有复制第三方代码。
