返回 MCP 目录
public公开dns本地运行

mcp-redmine

MCP Redmine是一个连接Claude Desktop与Redmine实例的工具,支持问题管理、文件上传下载和时间跟踪等功能。

article

README

🚀 MCP Redmine - 让Claude成为您的Redmine助手

MCP Redmine可将Claude Desktop与您的Redmine实例相连接,实现项目与问题的搜索浏览、问题创建更新、文件附件上传下载、时间条目管理跟踪、问题状态与字段更新等功能,还能访问全面的Redmine API功能,为您的项目管理带来极大便利。

目前项目使用良好,每天都在稳定运行,暂无已知错误。并且,我刚刚将包添加到PyPI并更新了使用说明,若您在使用过程中遇到任何问题,请随时报告。

MCP Redmine在行动

🚀 快速开始

MCP Redmine借助httpx进行API请求,并与Redmine OpenAPI规范集成,实现了全面的API覆盖,让您能更高效地使用Redmine。

✨ 主要特性

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

📦 安装指南

确保您已经安装了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", "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_URL | Redmine实例的URL | | REDMINE_API_KEY | Redmine API密钥 | | REDMINE_REQUEST_INSTRUCTIONS | 可选,指定包含请求说明的文件路径 |

基础用法

创建新问题

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

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

搜索问题

能否找到“网站”项目中所有优先级为高的未分配问题?

更新问题状态

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

记录时间

今天针对问题#456记录3.5小时的进度,用于“实现用户身份验证”。

🤝 项目贡献

欢迎任何形式的贡献!无论是错误报告、功能请求、文档改进还是代码贡献,所有反馈都非常宝贵。您可以自由地:

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

我们的目标是使Redmine项目管理与Claude更好地结合,您的见解和贡献将助力我们实现这一目标。

🙏 致谢

这个项目建立在他人优秀工作的基础上:

📄 许可证

Mozilla公共许可证第2.0版

🌟 我的其他LLM项目

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端