MCP Redmine

状态：运行良好，目前处于日常使用中且未发现任何已知问题。

状态2：我刚刚将该包发布到PyPI并更新了使用说明。如有任何问题请随时反馈 :)

让Claude成为你的Redmine助手！MCP Redmine将Claude Desktop连接到你的Redmine实例，使其能够：

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

使用httpx进行API请求，并与Redmine OpenAPI规范集成以实现全面的API覆盖。

MCP Redmine运行示例

安装

确保已安装uv：

# 如果尚未安装uv，请执行以下命令
curl -LsSf https://astral.sh/uv/install.sh | sh

与Claude Desktop配合使用

在你的claude_desktop_config.json中添加以下配置：

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "mcp-redmine==2025.04.09.153531", 
               "--refresh-package", "mcp-redmine", "mcp-redmine"],
      "env": {
        "REDMINE_URL": "https://你的redmine实例地址.example.com",
        "REDMINE_API_KEY": "你的API密钥",
        "REDMINE_REQUEST_INSTRUCTIONS": "/path/to/instructions.md"
      }
    }
  }
}

环境变量

REDMINE_URL：你的Redmine实例地址（必填）
REDMINE_API_KEY：你的Redmine API密钥（必填，获取方式见下文）
REDMINE_REQUEST_INSTRUCTIONS：包含redmine_request工具额外指令的文件路径（可选）。我发现让LLM在会话后生成该文件效果很好。（示例1 示例2）

获取Redmine API密钥

登录你的Redmine实例
进入"我的账户"（通常位于右上角菜单中）
在页面右侧，你应该能看到"API访问密钥"
点击"显示"查看现有密钥或"生成"创建新密钥
复制该密钥用于配置

API

工具

redmine_paths_list
- 从OpenAPI规范返回可用的API路径列表
- 无需输入
- 返回包含路径模板列表的YAML字符串：
```
- /issues.json
- /projects.json
- /time_entries.json
...
```
redmine_paths_info
- 获取给定路径模板的完整路径信息
- 输入：path_templates（字符串列表）
- 返回包含请求路径API规范的YAML字符串：
```
/issues.json:
  get:
    operationId: getIssues
    parameters:
      - $ref: '#/components/parameters/format'
    ...
```
redmine_request
- 向Redmine API发送请求
- 输入：
  - path（字符串）：API端点路径（例如'/issues.json'）
  - method（字符串，可选）：使用的HTTP方法（默认为'get'）
  - data（对象，可选）：请求体的字典（用于POST/PUT）
  - params（对象，可选）：查询参数的字典
- 返回包含响应状态码、正文和错误消息的YAML字符串：
```
status_code: 200
body:
  issues:
    - id: 1
      subject: "修复登录页面"
      ...
error: ""
```
redmine_upload
- 上传文件到Redmine并获取附件令牌
- 输入：
  - file_path（字符串）：要上传文件的完整路径
  - description（字符串，可选）：文件的可选描述
- 返回与redmine_request相同格式的YAML字符串，包含上传令牌：
```
status_code: 201
body:
  upload:
    id: 7
    token: "7.ed32257a2ab0f7526c0d72c32994c58b131bb2c0775f7aa84aae01ea8397ea54"
error: ""
```
redmine_download
- 从Redmine下载附件并保存到本地文件
- 输入：
  - attachment_id（整数）：要下载的附件ID
  - save_path（字符串）：文件应保存的完整路径
  - filename（字符串，可选）：要使用的可选文件名（如果未提供则自动确定）
- 返回下载结果的YAML字符串：
```
status_code: 200
body:
  saved_to: "/path/to/downloaded/file.pdf"
  filename: "file.pdf"
error: ""
```

示例

创建新问题

让我们在"网站"项目中创建一个新的错误报告：

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

搜索问题

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

更新问题状态

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

记录时间

为今天完成的"实现用户认证"工作，在问题#456上记录3.5小时。

MCP目录列表

MCP Redmine列在以下MCP目录站点和存储库中：

MCP.so
Glama

开发

首先克隆GitHub仓库并安装依赖项：

git clone git@github.com:runekaagaard/mcp-redmine.git
cd mcp-redmine
uv sync

然后在claude_desktop_config.json中设置：

...
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-redmine", "-m", "mcp_redmine.server", "main"],
...

我的其他LLM项目

MCP Alchemy - 将Claude Desktop连接到数据库以探索模式和运行SQL。
MCP Notmuch Sendmail - 使用notmuch的Claude Desktop电子邮件助手。
Diffpilot - 具有文件分组和标记功能的多列git差异查看器。
Claude Local Files - 在Claude Desktop工件中访问本地文件。

贡献

热烈欢迎贡献！无论是错误报告、功能请求、文档改进还是代码贡献 - 所有输入都很有价值。请随时：

开一个问题报告错误或建议功能
提交包含改进的拉取请求
增强文档或分享你的使用示例
提问并分享你的经验

我们的目标是让Claude的Redmine项目管理变得更好，你的见解和贡献有助于实现这一目标。

致谢

本项目基于其他优秀工作：

httpx - 用于处理HTTP请求
Redmine OpenAPI Specification - 用于全面的API规范
Redmine - 灵活的项目管理Web应用程序

许可证

Mozilla公共许可证版本2.0