redmine-mcp-server Skill 技能

连接 AI 助手与 Redmine 项目管理系统的 MCP 服务器

AI Agent

查看 Skill ↗

redmine-mcp-server 是连接 AI 助手与 Redmine 项目管理系统的 MCP 服务器。它将 Redmine 的项目、问题、工时跟踪、Wiki 页面、文件等资源作为 MCP 工具暴露给 AI，支持通过自然语言管理 Redmine 的完整工作流程。

技能简介

Redmine 是广受欢迎的开源项目管理工具，但通过 Web UI 或 REST API 管理工时、事务、Wiki 仍然繁琐。redmine-mcp-server 将这些能力转化为 AI 可调用的 MCP 工具——Agent 可以直接创建、查询、更新 Redmine 中的工时条目、问题、文件，无需人工在 UI 中操作。对于在代码编写过程中进行时间记录、或在 PR 过程中自动更新任务状态，redmine-mcp-server 提供了一个自然的 AI 驱动界面。

核心能力

45 个 MCP 工具（标准 Redmine）/ 58 个（含 RedmineUP 和 DMSF 插件扩展）
交互式 Kanban 面板：show_triage_board 在 MCP Apps 扩展的聊天界面中渲染实时可拖拽的问题看板
灵活认证：支持 API Key、用户名/密码、OAuth2 每用户 Token 三种模式
提示注入防护：用户内容包装在边界标签内，安全供 LLM 使用
只读模式：REDMINE_MCP_READ_ONLY=true 限制为只读操作
HTTP 文件服务：通过 UUID URL 安全访问附件，支持自动过期
分页支持：可配置限制处理大结果集
MCP 兼容：基于 FastMCP 构建，支持 HTTP 传输
Docker 支持：提供 Dockerfile、docker-compose 和预构建镜像
Redmine 6.1 / 7.0 兼容：集成测试套件完整覆盖两个版本

安装配置

步骤 1：安装

pip install redmine-mcp-server

步骤 2：创建配置文件

cat &gt; .env &lt;&lt; &#039;EOF&#039;
# Redmine 连接（必填）
REDMINE_URL=https://your-redmine-server.com

# 认证方式（二选一）
# 方式一：API Key（推荐）
REDMINE_API_KEY=your_api_key
# 方式二：用户名/密码
# REDMINE_USERNAME=your_username
# REDDMINE_PASSWORD=your_password

# 服务器配置（可选）
SERVER_HOST=0.0.0.0
SERVER_PORT=8000

# 公共 URL（文件服务用，可选）
PUBLIC_HOST=localhost
PUBLIC_PORT=8000

# 文件管理（可选）
ATTACHMENTS_DIR=./attachments
AUTO_CLEANUP_ENABLED=true
CLEANUP_INTERVAL_MINUTES=10
ATTACHMENT_EXPIRES_MINUTES=60
EOF

步骤 3：启动服务器

redmine-mcp-server
# 或
python -m redmine_mcp_server.main

步骤 4：配置 MCP 客户端

服务器运行在 http://localhost:8000，MCP 端点为 /mcp。在各 MCP 客户端中添加服务器地址即可使用。

使用步骤

安装并启动 redmine-mcp-server
在 MCP 客户端中配置服务器地址：http://localhost:8000/mcp
验证连接：访问 /health 端点确认服务正常
列出可用工具：list_tools 查看所有 45+ MCP 工具
创建工时记录：调用 create_time_entry 记录工作时长
更新问题状态：调用 update_issue 修改问题属性
查看看板：show_triage_board 在支持扩展的客户端渲染看板

适用场景

工时自动化记录：代码编写过程中 Agent 自动记录工时，无需手动填写
PR → 任务状态联动：PR 创建时自动将关联 Redmine 问题的状态更新为"review"
Sprint 看板管理：通过自然语言查询和更新 Sprint 中的问题状态
Wiki 内容维护：Agent 编写代码后自动生成或更新相关 Wiki 页面
报告生成：汇总工时数据、问题进度，输出结构化报告
CI/CD 集成：构建完成后自动记录工时或更新任务状态

适用人群

使用 Redmine 的开发团队：需要 AI 辅助管理 Redmine 项目的工程师
项目经理：通过自然语言查询 Redmine 数据、生成工时报告的管理者
AI Agent 开发者：需要让 Agent 与 Redmine 集成的工程师
DevOps 工程师：将 Redmine 工时记录集成到 CI/CD 流程的工程师

工作原理

redmine-mcp-server 基于 FastMCP 框架构建，通过 Redmine REST API 与 Redmine 实例通信。启动时读取 .env 配置建立连接，注册所有 MCP 工具。工具调用通过 HTTP transport 暴露，响应遵循 MCP 协议规范。对于有副作用的操作（创建/更新/删除），工具在执行前检查只读模式设置。文件附件通过 UUID-based URL 安全访问，支持自动清理过期文件。

官方链接

PyPI：https://pypi.org/project/redmine-mcp-server/
GitHub：https://github.com/jztan/redmine-mcp-server
官方演示：https://redmine-mcp-server.jztan.com
工具参考：docs/tool-reference.md
Redmine 兼容性：6.1 / 7.0

团队信息

AI产品库官方

由 AI 猎手自动发现

评论与建议

0 条评论