qod-ppm-odoo-mcp

用于 QOD PPM Odoo 插件的 MCP 服务器。

将插件的按钮、向导和工作流转换公开为 MCP 工具——这是通用 Odoo CRUD 服务器无法表达的功能。

设计

此服务器旨在保持轻量级。它不会重新实现 Odoo CRUD。请将其与通用的 Odoo MCP（例如 ivnvxd/mcp-server-odoo）一起运行：

简而言之：如果 Odoo UI 中有一个按钮在点击时执行非简单操作，那么它就是这里的工具。 CRUD 封装字段；而此工具封装按钮。

Related MCP server: mcp-server-odoo

安装

pip install qod-ppm-odoo-mcp

或从源码安装：

git clone https://github.com/wethti/qod-ppm-odoo-mcp
cd qod-ppm-odoo-mcp
pip install -e .

配置

在 Odoo 中创建一个服务用户，并为其分配所需的 PPM 组（group_ppm_admin 或范围限定的替代方案）。从用户的偏好设置页面生成 API 密钥。然后设置：

export ODOO_URL="https://your-odoo.example.com"
export ODOO_DB="your_db_name"
export ODOO_USERNAME="ppm-service@example.com"
export ODOO_API_KEY="…"   # preferred
# or ODOO_PASSWORD="…"

包含一个 .env.example 文件。

运行

stdio (默认) — 适用于 Claude Desktop / Claude Code / 任何将 MCP 服务器作为子进程启动的程序：

qod-ppm-mcp

Streamable HTTP — 适用于远程访问（其他 VPS、代理主机等）：

export QOD_PPM_MCP_TRANSPORT=http
export QOD_PPM_MCP_HOST=0.0.0.0
export QOD_PPM_MCP_PORT=8765
qod-ppm-mcp

如果暴露在互联网上，请在前面放置一个带有 TLS + 身份验证的反向代理。

Claude Code / Claude Desktop 配置

添加到 ~/.claude.json (Claude Code) 或 claude_desktop_config.json：

{
  "mcpServers": {
    "qod-ppm": {
      "command": "qod-ppm-mcp",
      "env": {
        "ODOO_URL": "https://your-odoo.example.com",
        "ODOO_DB": "your_db_name",
        "ODOO_USERNAME": "ppm-service@example.com",
        "ODOO_API_KEY": "…"
      }
    },
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo.example.com",
        "ODOO_DB": "your_db_name",
        "ODOO_USERNAME": "ppm-service@example.com",
        "ODOO_API_KEY": "…"
      }
    }
  }
}

两个服务器都指向同一个 Odoo。Claude 会看到命名空间为 mcp__qod-ppm__*（工作流操作）和 mcp__odoo__*（通用 CRUD）的工具。

工具参考

调用 ppm_list_action_tools 以在运行时获取当前列表。分组如下：

里程碑 (ppm.milestone)

• ppm_milestone_start / achieve / miss / cancel / reopen

状态报告 (ppm.status.report + 向导)

• ppm_status_report_generate(project_id, period?, commentary?) — 运行向导，自动填充 RAG/预算/风险/里程碑，创建报告

• ppm_status_report_publish(report_id)

• ppm_status_report_reset_draft(report_id)

• ppm_status_report_print_url(report_id) — 返回 PDF 操作

变更请求 (ppm.change.request + 拒绝向导)

• ppm_change_request_submit / start_review / approve / reset_draft

• ppm_change_request_reject(cr_id, reason) — 运行拒绝向导

风险 (ppm.risk)

• 工作流：ppm_risk_start_analysis / start_mitigation / start_monitoring / mark_occurred / close / reopen

• ppm_risk_move_in_matrix(risk_id, probability, impact) — 概率和影响为 1–5 的整数；服务器重新计算分数和等级

问题 (标记为 issue_type 的风险)

• ppm_issue_assign / start / resolve / escalate

角色分配 (ppm.role.assignment)

• ppm_role_activate / approve_and_activate / revoke / reset_draft （每个都会同步 Odoo 安全组）

导出 (向导 → XLSX)

• ppm_export_budget(project_id?, portfolio_id?, date_from?, date_to?, category_id?, include_closed?)

• ppm_export_risks(project_id?, portfolio_id?, risk_level?, include_closed?)

• ppm_export_resources(project_id?, employee_id?, department_id?, date_from?, date_to?, include_cancelled?)

这三个工具都返回一个指向 /web/content/<id>?download=true 的 ir.actions.act_url。

客户卡片项目

• ppm_create_project_from_template(partner_id, template_id, project_name)

自省

• ppm_ping() — 身份验证 + 基本计数

• ppm_list_action_tools() — 自描述工具列表

兼容性

• Odoo 18.0 社区版 / 企业版

• QOD PPM 模块：qod_ppm_core, qod_ppm_budget, qod_ppm_change_request, qod_ppm_client_card_projects, qod_ppm_dashboard, qod_ppm_resource, qod_ppm_risk, qod_ppm_roles, qod_ppm_roles_crm, qod_ppm_roles_mrp, qod_ppm_scoring, qod_ppm_status, qod_ppm_task_status

许可证

LGPL-3.0-or-later — 与 QOD PPM 模块一致。