一个面向OpenProject的MCP服务器，允许本地AI代理通过结构化、受保护的工具读取和管理项目数据。

服务器作为 MCP 客户端的本地子进程运行，通过 stdio。它封装了 OpenProject API v3，并公开了项目、工作包、成员、版本、板块、时间条目等的类型工具。

在PyPI上阅读这篇文章？ 以下所有链接均指向GitHub仓库—— docs/ 页面和图片通过 git 仓库和源代码分发包， 安装包里没有。

为什么要用这个MCP

• 设计上上下文节约 — 简洁、代理状的响应代替原始HAL负载（原始API中每个项目~21字段+~46个链接）。在select下测量每个响应最多**−99%**个token数;完整数字请参见上下文效率。
• 受保护写入 — 每次写入都遵循预览后确认的模式;无法绕过该模式。
• 防御深度项目范围 — MCP的读写允许列表除了限制OpenProject自身的服务器端权限外，还限制令牌的有效范围。

OpenProject CE MCP

An MCP server for OpenProject that lets local AI agents read and manage project data through structured, guarded tools.

The server runs as a local subprocess of your MCP client over stdio. It wraps OpenProject API v3 and exposes typed tools for projects, work packages, memberships, versions, boards, meetings, time entries, and more.

Reading this on PyPI? All links below point to the GitHub repository — the docs/ pages and images ship in the git repo and source distribution, not in the installed package itself.

Why use this MCP

• Context-frugal by design — compact, agent-shaped responses instead of raw HAL payloads (~21 fields + ~46 links per item in the raw API). Measured up to −99% tokens per response with select; see Context efficiency for the full numbers.
• Guarded writes — every write follows a preview-then-confirm pattern; there is no way to bypass it.
• Defense-in-depth project scope — MCP read/write allowlists restrict the token’s effective scope in addition to OpenProject’s own server-side permissions.
• Typed tools, not a raw REST client — one call per intent (list, search, create, update) instead of hand-built HAL requests and link-following.

---

What you can do

Projects

• List, create, copy, update, and delete projects
• Read project configurations, lifecycle phases, and admin context
• Create, update, and delete memberships and versions; list roles

Work packages

• List and search work packages with structured filters
• Create, update, and delete work packages; create subtasks; create, update, and delete relations; add comments (no edit or delete)
• Upload, read (images and text inlined for the model), and delete attachments; add and remove watchers; read activity logs
• Log, update, and delete time entries

Boards and views

• Create, read, update, and delete saved boards (queries); read views

Meetings

• Create, read, update, and delete meetings with their agenda items, sections, and outcomes