Redmine MCP 服务器

这是 Redmine 的模型上下文协议 (MCP) 服务器实现。它与 Redmine 的 REST API 集成，为 LLM 提供工单和项目信息。

特征

支持来自 Redmine REST API 的稳定资源：

• 问题（1.0~）

• 项目（1.0~）

• 用户（1.1~）

• 时间条目（1.1~）

工具

问题

• 搜索问题

  • 按项目、状态、受让人等进行过滤。

  • 关键词搜索

  • 自定义字段支持

• 创建/更新问题

  • 设置跟踪器、状态、优先级

  • 配置自定义字段

  • 添加评论

• 删除问题

项目

• 搜索项目

  • 按活动/存档/关闭状态过滤

  • 关键词搜索

• 获取项目详细信息

  • 包括追踪器、类别信息

• 创建/更新项目

  • 配置模块和跟踪器

  • 设置成员继承

• 存档/取消存档项目

• 删除项目

时间条目

• 搜索时间条目

  • 按项目、用户、日期范围过滤

• 获取时间输入详细信息

• 创建/更新时间条目

  • 针对项目或问题进行记录

  • 指定活动

  • 自定义字段支持

• 删除时间条目

Related MCP server: MCP Ethers Wallet

与 Claude 一起使用

要将此服务器与 Claude 一起使用，请按如下方式配置它：

配置选项

• command ：执行 npm 包的命令

• args ：

  • -y ：对提示自动回复“是”

  • --prefix ：指定安装目录

  • 最后一个参数指定包名称

• env ：环境变量

  • REDMINE_HOST ：Redmine 服务器 URL

  • REDMINE_API_KEY ：您的 Redmine API 密钥

设置

获取 API 密钥

1. 在 Redmine 管理设置中启用 REST API

2. 从用户设置页面获取 API 密钥

环境变量

设置以下环境变量：

• REDMINE_API_KEY ：从 Redmine 用户设置中获取的 API 密钥

• REDMINE_HOST ：Redmine 服务器 URL（例如， https://redmine.example.com ）

测试

单元测试

为了数据安全，测试中只包含GET操作。

检查员测试

使用MCP Inspector验证功能：

权限

某些功能需要管理员权限：

用户相关操作

• list_users ：需要管理员

• create_user ：需要管理员

• update_user ：需要管理员

• delete_user ：需要管理员

可用信息因用户权限级别而异。有关详情，请参阅Redmine API 文档。

发展

要求

• Node.js 18 或更高版本

• npm 9 或更高版本

图书馆

• @modelcontextprotocol/sdk : MCP SDK

• zod ：模式验证

• typescript ：类型系统

目录结构

建筑

架构决策记录

主要设计决策记录在docs/adr中。添加或修改功能时请参考这些文档。

执照

麻省理工学院

相关项目

• 模型上下文协议

• MCP TypeScript SDK

• Redmine