MCP Redmine

MCP Redmine

状态：工作良好，日常使用中没有任何已知的错误。

状态2：我刚刚将包添加到PyPI并更新了使用说明。请报告任何问题：）

让克劳德做你的Redmine助手！MCP Redmine将Claude Desktop连接到您的Redmine实例，使其能够：

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

对API请求使用httpx，并与Redmine OpenAPI规范集成，以全面覆盖API。

使用Claude Desktop

1.安装使用 uv

确保你安装了紫外线。

uv --version

如果你还没有安装uv。

• Linux

  curl -LsSf https://astral.sh/uv/install.sh | sh

• macOS

  brew install uv

• 窗户

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

添加到您的 claude_desktop_config.json:

  {
    "mcpServers": {
      "redmine": {
        "command": "uvx",
        "args": ["--from", "mcp-redmine==2026.01.13.152335",
                "--refresh-package", "mcp-redmine", "mcp-redmine"],
        "env": {
          "REDMINE_URL": "https://your-redmine-instance.example.com",
          "REDMINE_API_KEY": "your-api-key",
          "REDMINE_REQUEST_INSTRUCTIONS": "/path/to/instructions.md",
          "REDMINE_ALLOWED_DIRECTORIES": "/tmp,/home/user/uploads"
        }
      }
    }
  }

2.安装使用 docker

确保你已经安装了docker。

docker --version

构建docker镜像：

git clone git@github.com:runekaagaard/mcp-redmine.git
cd mcp-redmine
docker build -t mcp-redmine .

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "redmine": {
      "command": "docker",
      "args":  [
          "run",
          "-i",
          "--rm",
          "-e", "REDMINE_URL",
          "-e", "REDMINE_API_KEY",
          "-e", "REDMINE_REQUEST_INSTRUCTIONS",
          "-e", "REDMINE_ALLOWED_DIRECTORIES",
          "-v", "/path/to/instructions.md:/app/INSTRUCTIONS.md",
          "-v", "/path/to/uploads:/app/uploads",
          "mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.example.com",
        "REDMINE_API_KEY": "your-api-key",
        "REDMINE_REQUEST_INSTRUCTIONS": "/app/INSTRUCTIONS.md",
        "REDMINE_ALLOWED_DIRECTORIES": "/app/uploads"
      }
    }
  }
}

环境变量

备注：通过Docker运行时 REDMINE_REQUEST_INSTRUCTIONS 环境变量必须指向 容器内的路径，而不是主机上的路径。 因此，如果你想使用本地文件，你需要 把它装进容器里 在正确的位置。

安全说明：The REDMINE_ALLOWED_DIRECTORIES 设置可防止路径遍历攻击。路径包含 ../ 在验证之前解决，确保文件只能在允许的目录中访问。

获取您的Redmine API密钥

1. 登录您的Redmine实例
2. 转到“我的帐户”（通常位于右上角菜单中）
3. 在页面的右侧，您应该看到“API访问密钥”
4. 单击“显示”查看现有密钥，或单击“生成”创建新密钥
5. 复制此密钥以在配置中使用

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 （object，可选）：请求体字典（用于POST/PUT） - params （对象，可选）：查询参数字典 - 返回包含响应状态代码、正文和错误消息的YAML字符串：

  status_code: 200
  body:
    issues:
      - id: 1
        subject: "Fix login page"
        ...
  error: ""

• redmine_upload

- 将文件上传到Redmine并获取附件令牌 - 需要 REDMINE_ALLOWED_DIRECTORIES 待设置 - 输入： - file_path （string）：要上传的文件的完全限定路径（必须在允许的目录内） - description （string，可选）：文件的可选描述 - 返回与redmine_request格式相同的YAML字符串，包括上传令牌：

  status_code: 201
  body:
    upload:
      id: 7
      token: "7.ed32257a2ab0f7526c0d72c32994c58b131bb2c0775f7aa84aae01ea8397ea54"
  error: ""

• redmine_下载

- 从Redmine下载附件并将其保存到本地文件 - 需要 REDMINE_ALLOWED_DIRECTORIES 待设置 - 输入： - attachment_id （整数）：要下载的附件的ID - save_path （string）：文件应保存的完全限定路径（必须在允许的目录内） - filename （字符串，可选）：要使用的可选文件名（如果未提供，则自动确定） - 返回带有下载结果的YAML字符串：

  status_code: 200
  body:
    saved_to: "/path/to/downloaded/file.pdf"
    filename: "file.pdf"
  error: ""

例子

创建新问题

Let's create a new bug report in the "Website" project:

1. Title: "Homepage not loading on mobile devices"
2. Description: "When accessing the homepage from iOS or Android devices, the loading spinner appears but the content never loads. This issue started after the last deployment."
3. Priority: High
4. Assign to: John Smith

搜索问题

Can you find all high priority issues in the "Website" project that are currently unassigned?

更新问题状态

Please mark issue #123 as "In Progress" and add a comment: "I've started working on this issue. Expect it to be completed by Friday."

记录时间

Log 3.5 hours against issue #456 for "Implementing user authentication" done today.

MCP目录列表

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

• MCP.so
• 格拉玛

开发中

首先克隆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炼金术 -将Claude Desktop连接到数据库，以探索模式和运行SQL。
• MCP发送邮件不多 -Claude Desktop的电子邮件助手使用不多。
• Diffpilot 的 -带文件分组和标记的多列git diff查看器。
• 克劳德本地文件 -访问Claude Desktop工件中的本地文件。

贡献

热忱欢迎投稿！无论是错误报告、功能请求、文档改进还是代码贡献，所有的输入都是有价值的。请随意：

• 打开问题以报告错误或建议功能
• 提交带有改进的拉取请求
• 增强文档或分享您的使用示例
• 提问并分享你的经验

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

致谢

该项目建立在其他人出色工作的基础上：

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

许可证

Mozilla公共许可证版本2.0