OpenProject MCP Server

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"
      }
    }
  }
}

可用工具

用法示例

列出功能的子项

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"
})

环境变量

需求

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

许可证

麻省理工学院

贡献

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

链接

• OpenProject API文档
• 模型上下文协议