Redmine MCP
用于Redmine集成的MCP服务器。具有35个API工具的高性能Rust实现。
特性
- 35 API工具 -完全覆盖Redmine API
- 日志查看器 -支持WebSocket的实时基于web的日志查看器
- 交叉平台的 -适用于macOS、Linux和Windows的预构建二进制文件
- 高性能 -具有异步I/O的原生Rust实现
工具类别
| 类别 | 工具 |
|---|---|
| 问题 | 获取问题、获取问题、更新问题、获取期刊 |
| 时间条目 | get_Time_entrys、create_Time_entry、get_activities |
| 项目和用户 | 获取项目、获取成员、获取用户、获取当前用户 |
| Wiki | get_Wiki_pages、get_Wiki-page、update_Wiki_page |
| 文件 | 获取文件、获取附件、上传、下载 |
| 搜索 | 搜索（跨问题/wiki/新闻的全文） |
| 通用 | 请求（自定义API调用） |
| 实用程序 | log_viewer |
安装
选项1:克劳德代码市场（推荐）
直接从Claude代码安装：
claude mcp add-from-url https://github.com/Sunalamye/RedmineMCP然后设置环境变量：
export REDMINE_URL="https://your-redmine.example.com"
export REDMINE_TOKEN="your-api-token-here"该二进制文件将在首次使用时自动下载。
选项2：手动下载
预构建的二进制文件可从 发布 页面。
| 平台 | 文件 | 架构 |
|---|---|---|
| macOS | redmine-mcp-*-macos-arm64 | 苹果硅（M1/M2/M3） |
| Linux | redmine-mcp-*-linux-arm64 | ARM64 |
| 窗户 | redmine-mcp-*-windows-x64.exe | x64 |
快速开始
1.获取您的API代币
- 登录您的Redmine实例
- 首选 我的账户 （点击您的用户名）
- 找到 API访问密钥 在右侧边栏上
- 点击 展示 显示您的令牌
2.配置MCP客户端（仅限手动安装）
如果您是通过市场安装的，请跳过此部分-MCP是自动配置的。
克劳德代码
创建 .mcp.json 在您的项目目录中：
{
"mcpServers": {
"redmine": {
"command": "/path/to/redmine-mcp",
"env": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_TOKEN": "your-api-token-here",
"LOG_VIEWER": "true"
}
}
}
}开源代码
创建 opencode.json 在您的项目目录中：
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"redmine": {
"type": "local",
"command": ["/path/to/redmine-mcp"],
"enabled": true,
"environment": {
"REDMINE_URL": "https://your-redmine.example.com",
"REDMINE_TOKEN": "your-api-token-here"
}
}
}
}环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
REDMINE_URL | 是 | - | Redmine实例URL |
REDMINE_TOKEN | 是 | - | neneneba API令牌 |
LOG_LEVEL | 没有 | info | 日志级别：调试/信息/警告/错误 |
LOG_VIEWER | 没有 | true | 启用日志查看器web UI |
LOG_VIEWER_PORT | 没有 | 3456 | 日志查看器服务器端口 |
LOG_VIEWER_OPEN | 没有 | true | 启动时自动打开浏览器 |
使用示例
# Get all open issues
redmine_get_issues(status_id: "open")
# Get issues assigned to me
redmine_get_issues(assigned_to_id: "me")
# Get single issue with history
redmine_get_issue(id: 12345)
# Add a note to an issue
redmine_update_issue(id: 12345, notes: "Task completed")
# Log time on an issue
redmine_create_time_entry(issue_id: 12345, hours: 2, comments: "Bug fix")
# Full-text search
redmine_search(q: "authentication", scope: "issues")
# Open Log Viewer in browser
redmine_log_viewer(open: true)日志查看器
内置的日志查看器提供对MCP请求的实时监控：
- 实时更新 通过WebSocket
- 按级别过滤 （调试/信息/警告/错误）
- 按工具筛选 名字
- JSON查看器 用于请求/响应数据
- 自动编辑 的敏感数据（API令牌）
访问地址： http://localhost:3456 当服务器正在运行时。
从源头构建
先决条件
- 锈蚀1.75+（含
cargo) - 交叉编译：
cargo-zigbuild
构建
cd rust
# Debug build
cargo build
# Release build
cargo build --release
# Cross-compile for multiple platforms
./build-release.sh测试
提供了一个Docker Compose文件用于本地测试：
cd rust/test
docker-compose up -d
# Access Redmine at http://localhost:3000
# Default login: admin / admin
# Enable API: Administration → Settings → API → Enable REST web service安全说明
.mcp.json和opencode.json包含您的API令牌- 不要将这些文件提交到版本控制
- 日志查看器自动编辑日志中的API令牌
许可证
麻省理工学院