OpenProject

Name: OpenProject
Author: alex13slem

本地服务

github.com/alex13slem生产力015 周前更新

代码仓库

关于 OpenProject

OpenProject MCP server 通过 OpenProject API v3 将 MCP 客户端连接到项目和工作包管理功能。其 41 个工具还涵盖文件、看板、用户、通知和参考数据，并为读写及破坏性操作添加注解。

主要功能

01项目增删改查与筛选
02工作包搜索和编辑
03附件上传与读取
04关联和关注者管理
05用户、通知与看板
06受限 API 透传

适用场景

01查找并更新工作包
02上传或查看附件
03管理项目关注者和关联
04检查通知与看板数据

MCP 相关

通过 stdio MCP 服务提供 41 个用于 OpenProject API v3 的工具。工具注解标识读、写和破坏性操作，供兼容客户端采用相应策略。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "alex13slem-openproject": {
      "command": "npx",
      "args": [
        "-y",
        "openproject-codex-plugin"
      ],
      "env": {
        "OPENPROJECT_URL": "<OPENPROJECT_URL>",
        "OPENPROJECT_API_TOKEN": "<OPENPROJECT_API_TOKEN>",
        "OPENPROJECT_PAGE_SIZE": "<OPENPROJECT_PAGE_SIZE>",
        "OPENPROJECT_TIMEOUT_MS": "<OPENPROJECT_TIMEOUT_MS>",
        "OPENPROJECT_AUTH_MODE": "<OPENPROJECT_AUTH_MODE>",
        "OPENPROJECT_ALLOWED_UPLOAD_DIRS": "<OPENPROJECT_ALLOWED_UPLOAD_DIRS>"
      }
    }
  }
}

启动命令npx -y openproject-codex-plugin

需要配置的环境变量

OPENPROJECT_URLRoot URL of the OpenProject instance

OPENPROJECT_API_TOKEN密钥OpenProject API token

OPENPROJECT_PAGE_SIZEDefault page size from 1 to 100

OPENPROJECT_TIMEOUT_MSRequest timeout in milliseconds from 1000 to 300000

OPENPROJECT_AUTH_MODE密钥API-token authentication mode: basic for broad compatibility or bearer for OpenProject 17.2+

OPENPROJECT_ALLOWED_UPLOAD_DIRSPlatform-separated directories from which attachment files may be read; defaults to the process working directory

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmopenproject-codex-plugin0.5.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
query	string	否	不区分大小写的名称或标识符片段；与筛选条件组合时使用 AND
offset	integer	否
sortBy	array	否
filters	array	否
pageSize	integer	否

详细介绍

OpenProject MCP 服务

一个功能全面、支持写入的 OpenProject API v3 模型上下文协议服务。它提供 41 个专用工具，涵盖项目、工作包、附件、关系、看板、用户、关注者、通知和参考数据。

附件工具可以列出工作包中的文件并获取其内容。基于文本的文件会直接返回；二进制文件则作为嵌入式 MCP 资源返回。每个请求的上传和下载均有大小限制。

此软件包作为 OpenProject for Codex 的一部分维护，该项目还包括 Codex 工作流指南和便携式安装程序。

使用 MCP 客户端运行

配置以下环境变量：

OPENPROJECT_URL：OpenProject 实例的根 URL；
OPENPROJECT_API_TOKEN：仅具有所需权限的 API 令牌。

现有 MCP 配置也可以使用 OPENPROJECT_BASE_URL 和 OPENPROJECT_API_KEY 作为兼容别名。

可选设置：

OPENPROJECT_PAGE_SIZE：默认集合页面大小，范围为 1 到 100（默认值：25）；
OPENPROJECT_TIMEOUT_MS：请求超时时间，范围为 1000 到 300000 毫秒（默认值：30000）；
OPENPROJECT_AUTH_MODE：basic 可提供广泛兼容性（默认值），或为 OpenProject 17.2 及更高版本使用 bearer。
OPENPROJECT_ALLOWED_UPLOAD_DIRS：上传工具可读取文件的平台专用目录列表（默认值：当前工作目录）。

然后使用以下命令启动 stdio 服务：

npx -y openproject-codex-plugin

MCP 配置示例：

{
  "mcpServers": {
    "openproject": {
      "command": "npx",
      "args": ["-y", "openproject-codex-plugin"],
      "env": {
        "OPENPROJECT_URL": "https://tasks.example.com",
        "OPENPROJECT_API_TOKEN": "your-api-token"
      }
    }
  }
}

切勿提交 API 令牌，也不要将其包含在公开日志和屏幕截图中。