README
🚀 MCP Redmine - 让Claude成为您的Redmine助手
MCP Redmine可将Claude Desktop与您的Redmine实例相连接,实现项目与问题的搜索浏览、问题创建更新、文件附件上传下载、时间条目管理跟踪、问题状态与字段更新等功能,还能访问全面的Redmine API功能,为您的项目管理带来极大便利。
目前项目使用良好,每天都在稳定运行,暂无已知错误。并且,我刚刚将包添加到PyPI并更新了使用说明,若您在使用过程中遇到任何问题,请随时报告。

🚀 快速开始
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更好地结合,您的见解和贡献将助力我们实现这一目标。
🙏 致谢
这个项目建立在他人优秀工作的基础上:
- httpx - 处理HTTP请求
- Redmine OpenAPI规范 - 用于全面的API规范
- Redmine - 灵活的项目管理Web应用程序
📄 许可证
Mozilla公共许可证第2.0版
🌟 我的其他LLM项目
- MCP Alchemy - 将Claude Desktop连接到数据库以探索模式和运行SQL。
- MCP Notmuch Sendmail - 使用notmuch的Claude Desktop电子邮件助手。
- Diffpilot - 具有文件分组和标记功能的多列git diff查看器。
- Claude Local Files - 在Claude Desktop插件中访问本地文件。
扫码联系在线客服