MCP Redmine

MCP Redmine

site icon
2025.04.16 7
Python项目管理API 集成交流协作开发效率
MCP Redmine 是一个将 Claude Desktop 与 Redmine 实例连接的工具,旨在提升 Redmine 的项目管理效率。它允许用户通过 Claude 进行项目搜索、问题创建与更新、文件附件管理、时间记录跟踪等操作,支持全面的 Redmine API 功能。
View on GitHub

Overview

基本能力

产品定位

MCP Redmine 是一个专为 Redmine 设计的辅助工具,旨在通过 Claude Desktop 提升 Redmine 的项目管理效率和用户体验。

核心功能

  • 搜索和浏览项目及问题
  • 创建和更新问题(支持完整 Markdown)
  • 上传和下载文件附件
  • 管理和跟踪时间记录
  • 更新问题状态和字段
  • 访问全面的 Redmine API 功能

适用场景

  • 项目管理团队需要快速创建和更新问题
  • 开发团队需要高效管理文件附件和时间记录
  • 需要自动化 Redmine 操作以提高工作效率

工具列表

  • redmine_paths_list: 返回 OpenAPI 规范中可用的 API 路径列表
  • redmine_paths_info: 获取指定路径模板的完整路径信息
  • redmine_request: 向 Redmine API 发起请求
  • redmine_upload: 上传文件到 Redmine 并获取附件令牌
  • redmine_download: 从 Redmine 下载附件并保存到本地文件

常见问题解答

  • 如何获取 Redmine API 密钥?
  • 登录到 Redmine 实例
  • 转到“我的账户”
  • 在页面右侧找到“API 访问密钥”
  • 点击“显示”查看现有密钥或“生成”创建新密钥
  • 复制此密钥用于配置

使用教程

使用依赖

  • 访问 Redmine 实例
  • Redmine API 密钥
  • Python 3.10+

安装教程

  1. 克隆仓库:
git clone https://github.com/runekaagaard/mcp-redmine.git
  1. 确保已安装 uv:
# 如果尚未安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 将 Redmine 配置添加到 claude_desktop_config.json

调试方式

安装完成后,可以通过以下命令进行基本调试:

uv --directory /path/to/mcp-redmine run server.py

示例

创建新问题

让我们在“网站”项目中创建一个新的错误报告:

1. 标题:“主页在移动设备上无法加载”
2. 描述:“从 iOS 或 Android 设备访问主页时,加载旋转器出现但内容从未加载。此问题在上次部署后开始出现。”
3. 优先级:高
4. 分配给:John Smith

搜索问题

你能找到“网站”项目中所有当前未分配的高优先级问题吗?

更新问题状态

请将问题 #123 标记为“进行中”并添加评论:“我已开始处理此问题。预计周五完成。”

记录时间

今天为问题 #456 记录 3.5 小时,用于“实现用户认证”。

许可证

该项目遵循 MPL-2.0 开源许可条款,请参阅 MPL-2.0 了解完整条款。