Redmine MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 AI 助手能够与 Redmine 交互，以实现专注和透明的项目管理。

概述

此 MCP 服务器提供了一个 AI 助手和 Redmine 之间的桥梁，允许 AI 执行以下操作：

• 创建和更新具有适当分类的问题
• 管理 Wiki 页面和文档
• 跟踪项目状态和进度
• 遵循定义的流程以保持一致性

通过使用此 MCP 服务器，您可以确保 AI 工作保持专注、良好记录，并对人类团队成员完全透明。

特性

资源能力

• 问题: 访问 Redmine 问题，具有过滤和搜索功能
• 项目: 访问项目数据、类别和状态
• Wiki: 访问 Wiki 页面以获取文档

工具能力

• create_issue: 创建具有适当分类的新问题
• update_issue: 更新现有问题，包括状态更改和注释
• create_wiki: 创建或更新 Wiki 页面以获取文档
• get_project_status: 获取项目状态摘要和统计信息

提示能力

• issue_template: 用于创建结构良好的问题的模板
• wiki_template: 用于创建结构良好的 Wiki 页面的模板

要求

• Python 3.9+
• Flask
• 具有 API 访问权限的 Redmine 实例
• Claude Desktop 或其他 MCP 兼容的 AI 助手

安装

1. 克隆存储库：

   git clone https://github.com/yourusername/redmine-mcp-server.git
   cd redmine-mcp-server
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 配置服务器：

   cp config.yaml.example config.yaml
   # 编辑 config.yaml，填写您的 Redmine URL 和 API 密钥
   

用法

运行服务器

使用以下命令启动服务器：

python main.py

服务器默认在端口 5000 上运行。

Docker 部署

构建并运行 Docker 容器：

docker build -t redmine-mcp-server .
docker run -d -p 5000:5000 -e REDMINE_API_KEY=your_api_key -e REDMINE_URL=http://localhost:3000 redmine-mcp-server

配置 Claude Desktop

将以下内容添加到您的 Claude Desktop MCP 配置中：

{
  "mcps": {
    "redmine": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "REDMINE_API_KEY",
        "-e",
        "REDMINE_URL",
        "redmine-mcp-server:latest"
      ],
      "environment": {
        "REDMINE_API_KEY": "your_redmine_api_key",
        "REDMINE_URL": "http://localhost:3000"
      }
    }
  }
}

API 参考

MCP 端点

• GET /mcp: 返回 MCP 功能
• GET /mcp/health: 返回健康状态

资源端点

• GET /mcp/resources/issues: 返回问题作为资源
• GET /mcp/resources/projects: 返回项目数据
• GET /mcp/resources/wiki: 返回 Wiki 页面

工具端点

• POST /mcp/tools/create_issue: 创建新问题
• POST /mcp/tools/update_issue: 更新现有问题
• POST /mcp/tools/create_wiki: 创建或更新 Wiki 页面
• POST /mcp/tools/get_project_status: 获取项目状态和统计信息

提示端点

• GET /mcp/prompts/issue_template: 返回用于创建问题的模板
• GET /mcp/prompts/wiki_template: 返回用于创建 Wiki 页面的模板

配置选项

可以使用 config.yaml 文件或环境变量配置服务器：

选项	环境变量	描述	默认值
redmine_url	REDMINE_URL	Redmine 实例的 URL	http://localhost:3000
redmine_api_key	REDMINE_API_KEY	用于 Redmine 身份验证的 API 密钥	None
server_port	SERVER_PORT	MCP 服务器的端口	5000
log_level	LOG_LEVEL	日志记录级别（INFO、DEBUG 等）	INFO
project_id	PROJECT_ID	默认 Redmine 项目 ID	1
default_category_id	DEFAULT_CATEGORY_ID	问题的默认类别 ID	3
default_tracker_id	DEFAULT_TRACKER_ID	问题的默认跟踪器 ID	2

流程优势

使用此 MCP 服务器为 AI 辅助项目管理提供以下几个好处：

1. 结构化文档: 所有 AI 工作都会自动记录在 Redmine 中
2. 清晰的流程: AI 任务遵循预定义的流程和类别
3. 透明度: 所有 AI 操作都会被记录并可追溯
4. 协作: 人类团队成员可以轻松审查和贡献 AI 工作
5. 进度跟踪: 项目经理可以通过 Redmine 跟踪 AI 任务进度

许可证

MIT 许可证

贡献

欢迎贡献！请随时提交 Pull Request。