Redmine MCP Server (Zacharyelston)

Redmine MCP服务器

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

概述

此MCP服务器在AI助手和Redmine之间提供了一座桥梁，使AI能够：

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

通过使用此MCP服务器，您可以确保人工智能工作保持专注、有据可查，并且对人类团队成员完全透明。

特性

资源能力

• 问题：访问Redmine时遇到过滤和搜索问题
• 项目：访问项目数据、类别和状态
• 维基：访问wiki页面以获取文档

工具功能

• 创建_发行：创建具有适当分类的新问题
• update_issue：用状态更改和注释更新现有问题
• create_wiki：为文档创建或更新wiki页面
• 获取项目状态：获取项目状态摘要和统计信息

快速能力

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

需求

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

安装

1. 克隆存储库：

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

1. 安装依赖项：

   pip install -r requirements.txt

1. 配置服务器：

   cp config.yaml.example config.yaml
   # Edit config.yaml with your Redmine URL and API key

用法

运行服务器

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

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桌面

将以下内容添加到您的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 文件或环境变量：

工艺优势

使用此MCP服务器为人工智能辅助项目管理提供了几个好处：

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

许可证

MIT许可证

贡献

欢迎投稿！请随时提交拉取请求。