OpenProject MCP Server 项目管理 91 工具 Skill 技能

技能简介

openproject-mcp-server 是一款把 OpenProject 项目管理平台完整 API v3 暴露为 MCP（Model Context Protocol）工具的服务器。它向 Claude 或任何 MCP 客户端一次性提供 91 个结构化工具，覆盖工作包（work packages）、评论与关联、附件、Git 与 PR 活动、项目、保存查询、通知、工时跟踪、版本、人员与成员、会议、新闻、预算与报表，并附带 4 个 report/workflow prompt 与 3 个 resource template。它主要面向 OpenProject 的社区版（Community edition），让自托管用户也能像企业版一样拥有内置 MCP 集成，但运行在任何版本下都只需要公开 API v3。

核心能力

• 91 个结构化工具：工作包、评论、关联、附件、Git/PR 活动、保存查询、通知、工时跟踪、版本、人员、会议、新闻、文档、预算、报表，覆盖项目管理全流程
• 4 个 Report/Workflow Prompt：内置报表与流程模板，让 Agent 直接以"请示-分析-报告"的范式驱动数据
• 3 个 Resource Template：把项目、工作包、报表等常用实体抽象为可订阅资源，便于上下文拼装
• Type-Safe 输出：每个工具返回类型化模型，客户端拿到 outputSchema 与机器可读的 structuredContent，而不是非结构化文本
• HTTP/2 与 httpx：底层使用 FastMCP 3.x 与 httpx，连接更快更稳，支持大批量调用
• 零代码生成：所有 schema 与工具描述均由 Python 类型注解驱动，OpenProject API 升级时同步更新

安装配置

pip install openproject-mcp-server
# 配置 OpenProject API 地址与 token
export OPENPROJECT_URL=https://openproject.example.com
export OPENPROJECT_API_TOKEN=xxxxxxxxxxxxxxxx
# 启动 stdio MCP 服务器
openproject-mcp-server

Claude Desktop / Cursor / Claude Code 等宿主只要在 MCP 服务器配置里把上述命令配进去即可立即获得 91 个工具。OpenProject 社区版自托管用户可直接对接；企业版用户可作为附加工具集备（企业版已自带官方 MCP，本服务器仍可并行运行补充工具）。

使用步骤

1. pip install openproject-mcp-server 并设置 OPENPROJECT_URL 与 OPENPROJECT_API_TOKEN 环境变量。
2. 在 Claude Desktop / Cursor / Claude Code 的 MCP 配置里把 openproject-mcp-server 注册为 stdio 命令。
3. 启动宿主并让 Agent 列出可用 MCP 工具，验证 91 个 openproject_* 工具全部加载成功。
4. 用 work package 工具查任务详情与关联，用 Git/PR 工具看提交与评审活动，再用报表/工作流 prompt 让 Agent 生成阶段性总结。
5. 借助 Resource Template 把项目或报表订阅为上下文，跨会话保持同一组项目数据。

适用场景

• 自托管 OpenProject 的 AI 化：让 Claude/Cursor/Claude Code 直接查询、自助提交、跟踪 OpenProject 上的工作包与会议
• 跨任务工作流编排：用 Agent 串起"工时记录 → 工作包状态 → 报表 → 通知"的端到端项目工作流
• 报表自动化：用 4 个内置 report prompt 让 Agent 拉取项目/工作包数据并按模板生成汇报
• 团队协作助手：把工作包评论、关联、附件、Git 活动交给 Agent 整理，方便项目经理与团队成员了解最新进展
• 自托管社区版升级：在官方内置 MCP 不可用的社区版下，靠 openproject-mcp-server 获得等效的 MCP 集成能力

适用人群

适合自托管 OpenProject 社区版的研发与运维团队、项目经理、技术 PMO，以及希望用 Claude/Cursor/Claude Code 接管项目管理任务的 AI 应用开发者与个人重度用户；任何需要把项目数据接入 LLM 工作流的场景都适用。

工作原理

openproject-mcp-server 基于 FastMCP 3.x 与 OpenProject API v3：把 REST 接口按"工作包 / 评论 / 关联 / 附件 / Git 活动 / 项目 / 保存查询 / 通知 / 工时 / 版本 / 人员 / 会议 / 新闻 / 文档 / 预算 / 报表"等域分门别类地包装为 91 个工具，每个工具通过 Python 类型注解自动推导 outputSchema 并以 structuredContent 返回，确保下游 Agent 拿到的是结构化结果而不是裸文本；HTTP/2 加速并降低延迟，Resource Template 把常用实体固化为可订阅资源，prompt 则把报表与工作流模板内置到服务器层。

官方链接

• GitHub 仓库：https://github.com/kar-thik/openproject-mcp
• PyPI 包：https://pypi.org/project/openproject-mcp-server/
• Glama 评分：https://glama.ai/mcp/servers/kar-thik/openproject-mcp
• MCP 注册名：io.github.kar-thik/openproject-mcp-server
• 适用宿主：Claude Desktop、Cursor、Claude Code、任何 MCP 兼容客户端
• OpenProject 主页：https://www.openproject.org