AI导哈

OpenProject MCP 服务

OpenProject MCP 服务器是一个用于 OpenProject API 集成的工具，使 AI 助手能够与 OpenProject 的工作包、项目和时间跟踪功能进行交互。

  • by cyborgx0x
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cyborgx0x/mcp-openproject

使用说明

OpenProject MCP服务器

用于OpenProject API集成的模型上下文协议（MCP）服务器。使AI助手能够与OpenProject工作包、项目和时间跟踪进行交互。

安装

全局安装（推荐）

npm install -g openproject-mcp

本地安装

npm install openproject-mcp

配置

获取OpenProject API密钥

  1. 登录您的OpenProject实例
  2. 首选 我的账户 → 访问令牌
  3. 创建新的API令牌
  4. 复制令牌

添加到Kiro MCP配置

添加到 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "openproject": {
      "command": "npx",
      "args": ["-y", "openproject-mcp"],
      "env": {
        "OPENPROJECT_URL": "https://your-openproject-instance.com",
        "OPENPROJECT_API_KEY": "your-api-key-here"
      }
    }
  }
}

或者，如果全局安装：

{
  "mcpServers": {
    "openproject": {
      "command": "openproject-mcp",
      "env": {
        "OPENPROJECT_URL": "https://your-openproject-instance.com",
        "OPENPROJECT_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

工具 说明
list_projects 列出所有项目
get_work_package 按ID获取工作包详细信息
list_work_packages 列出带有过滤器的工作包
get_children 获取父母的子女工作包
list_statuses 列出所有可用状态
list_types 列出所有工作包类型（功能、任务、Bug等）
get_user 获取用户信息
create_work_package 创建新的工作包
update_work_package 更新现有工作包
log_time 记录工作包的时间条目
raw_api_call 对任何终结点进行原始API调用

用法示例

列出功能的子项

get_children({ parentId: 211 })

创建新任务

create_work_package({
  subject: "Implement token budget management",
  parentId: 538,
  assigneeId: 10,
  startDate: "2026-01-15",
  dueDate: "2026-01-15"
})

列出分配给我的任务

list_work_packages({ assigneeId: "me" })

更新工作包状态

update_work_package({
  id: 123,
  statusId: 12,  // Status ID from list_statuses
  estimatedTime: "PT2H"  // 2 hours in ISO 8601 format
})

日志时间

log_time({
  workPackageId: 123,
  hours: 2.5,
  comment: "Implemented feature X",
  spentOn: "2026-01-23"
})

环境变量

变量 必填 描述
OPENPROJECT_URL 是 您的OpenProject实例URL
OPENPROJECT_API_KEY 是 来自OpenProject的API密钥

需求

  • Node.js>=18.0.0
  • 具有API访问权限的OpenProject实例

许可证

麻省理工学院

贡献

欢迎投稿！请打开问题或提交拉取请求。

链接

相关 MCP