🎯 为团队领导者提供智能化的项目报告生成工具
- 📊 智能报告生成 - 自动生成周报、月报、进度报告
- 🎯 风险评估 - 实时项目风险识别和评估
- 👥 工作负载分析 - 团队成员工作量分析和优化建议
- 🎨 模板系统 - 支持自定义报告模板，包含专业的日本式商务报告
- 🔌 MCP 协议 - 标准协议，易于集成到 Claude Desktop、Cursor 等 AI 工具
# 使用 Docker 启动 OpenProject
docker-compose up -d
# 访问 OpenProject: http://localhost:8090
# 默认账号: admin / admincd solution-fastapi
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
pip install -e ../mcp-core
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，设置你的 OpenProject API Key
# 启动服务
python app/main.pycd solution-http
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e ../mcp-core
python3 -m src.main| 服务 | FastAPI 方案 | HTTP 方案 |
|---|---|---|
| Web 界面 | http://localhost:8020/web/template_editor.html | http://localhost:8010 |
| API 文档 | http://localhost:8020/docs | - |
| MCP 端点 | http://localhost:8020/mcp | http://localhost:8010/mcp |
支持多种专业报告模板：
- 日本式週報 - 符合日本商务文化的详细周报
- 日本式月報 - 综合的月度总结报告
- 日本式進捗報告 - 专业的进度状况报告
- 自定义模板 - 通过 Web 界面创建和编辑
{
"mcpServers": {
"openproject": {
"command": "curl",
"args": ["-X", "POST", "http://localhost:8020/mcp"]
}
}
}在 Cursor 中添加 MCP 服务器配置，指向 http://localhost:8020/mcp
curl -X POST http://localhost:8020/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_report_from_template",
"arguments": {
"template_id": "japanese_weekly_report",
"project_id": "1"
}
}
}'curl -X POST http://localhost:8020/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "assess_project_risks",
"arguments": {
"project_id": "1"
}
}
}'# OpenProject 配置（必需）
OPENPROJECT_URL=https://your-openproject.com
OPENPROJECT_API_KEY=your-api-key-here
# 服务器配置
HOST=0.0.0.0
PORT=8020
# 日志配置
LOG_LEVEL=INFO- 登录 OpenProject
- 进入 "我的账户" → "访问令牌"
- 创建新的 API 密钥
- 复制密钥到
.env文件
Q: 服务启动失败，提示端口被占用
# 查找占用端口的进程
lsof -ti:8020 | xargs kill -9
# 重新启动服务Q: 无法连接到 OpenProject
- 检查 OpenProject 是否正在运行
- 验证 API Key 是否正确
- 确认网络连接正常
Q: 模板预览生成失败
- 检查项目 ID 是否存在
- 确认有访问该项目的权限
- 查看服务器日志获取详细错误信息
MIT License - 详见 LICENSE 文件
欢迎提交 Issue 和 Pull Request！