Redmine MCP Server

Redmine MCP Server

site icon
2025.01.09 15
TypeScript项目管理团队协作自动化报告交流协作
Redmine MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,专为 Redmine 设计。它通过集成 Redmine 的 REST API,为大型语言模型(LLMs)提供项目管理和问题跟踪的功能。该服务器支持从 Redmine 获取问题、项目、用户和时间条目等信息,并允许进行搜索、创建、更新和删除操作。
View on GitHub

Overview

基本能力

产品定位

Redmine MCP Server 是一个专为 Redmine 设计的 MCP 服务器实现,旨在通过 REST API 为 LLMs 提供项目管理和问题跟踪的功能。

核心功能

  • 问题管理:支持搜索、创建、更新和删除问题,包括自定义字段和评论功能。
  • 项目管理:支持搜索、创建、更新和删除项目,包括项目状态管理和模块配置。
  • 时间条目管理:支持搜索、创建、更新和删除时间条目,包括按项目和用户筛选。
  • 用户管理:支持获取用户信息,部分操作需要管理员权限。

适用场景

  • 项目管理:用于跟踪和管理项目中的问题和任务。
  • 团队协作:支持团队成员记录和跟踪工作时间。
  • 自动化报告:通过 API 获取项目状态和问题信息,生成自动化报告。

工具列表

  • Issues:搜索、创建、更新和删除问题。
  • Projects:搜索、创建、更新和删除项目。
  • Time Entries:搜索、创建、更新和删除时间条目。

常见问题解答

  • 权限问题:部分用户管理操作需要管理员权限。
  • API 配置:需要正确设置 REDMINE_HOSTREDMINE_API_KEY 环境变量。

使用教程

使用依赖

  • Node.js 18 或更高版本
  • npm 9 或更高版本

安装教程

  1. 安装依赖: bash npm install
  2. 配置环境变量: bash export REDMINE_HOST="https://your-redmine.example.com" export REDMINE_API_KEY="your-api-key-here"
  3. 启动服务器: bash npm run dev

调试方式

  1. 运行单元测试: bash npm test
  2. 使用 MCP Inspector 进行功能验证: bash npm run build chmod +x dist/index.js npx @modelcontextprotocol/inspector dist/index.js

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。