Redmine MCP Server

Redmine MCP Server

一个模型上下文协议服务器，用于通过与 LLM 集成，使用 Redmine 的 REST API 来交互，从而实现对工单、项目和用户数据的管理。

开发者工具
版本控制
客户支持
访问服务器

Tools

list_issues

List and search Redmine issues. Provides flexible filtering and sorting options. Supports filtering by custom fields using field IDs and patterns. Available since Redmine 1.0

create_issue

Create a new issue. Requires project ID and subject fields. Returns success or validation error status. Available since Redmine 1.0

list_projects

List all accessible projects. Shows both public projects and authorized private projects. Includes trackers, categories, modules and custom fields. Available since Redmine 1.0

update_issue

Update an existing issue. Modify any issue fields as needed. Returns success or validation error status. Available since Redmine 1.0

delete_issue

Delete an issue permanently. This action cannot be undone. Returns success status on completion. Available since Redmine 1.0

add_issue_watcher

Add a user as watcher to an issue. Enables user to receive issue updates. Available since Redmine 1.0

remove_issue_watcher

Remove a user from issue watchers. Stops issue update notifications. Available since Redmine 1.0

show_project

Get detailed project information. Specify using project ID or key. Supports retrieving additional data. Available since Redmine 1.0

create_project

Create a new project. Provide name and key. Configure optional settings like modules and trackers. Available since Redmine 1.0

update_project

Update project settings. Specify ID or key to identify project. Only specified fields will be changed. Available since Redmine 1.0

archive_project

Archive a project. Project becomes read only. Available since Redmine 5.0

unarchive_project

Restore an archived project. Project becomes editable again. Available since Redmine 5.0

delete_project

Delete project permanently. Deletes all project data and subprojects. This action cannot be undone. Available since Redmine 1.0

list_time_entries

List and search logged time records. Filter by user, project and date range. Returns up to 100 entries per request. Available since Redmine 1.1

show_time_entry

Get details of a time record. Returns complete information. Available since Redmine 1.1

create_time_entry

Record spent time on projects or issues. Hours and project or issue ID required. Activity type ID required if no default exists. Available since Redmine 1.1

update_time_entry

Update an existing time record. Modify hours, activity and comments. Cannot change project after creation. Available since Redmine 1.1

delete_time_entry

Delete a time record permanently. This action cannot be undone. Available since Redmine 1.1

list_users

List all users in the system. Shows active and locked accounts. Admin privileges required. Available since Redmine 1.1

show_user

Get details of a specific user. Use 'current' to get your own info. Returned fields depend on privileges. Available since Redmine 1.1

create_user

Create a new user account. Admin privileges required. Returns success or validation error status. Available since Redmine 1.1

update_user

Update an existing user. Admin privileges required. Returns success or validation error status. Available since Redmine 1.1

delete_user

Delete a user permanently. Admin privileges required. This action cannot be undone. Available since Redmine 1.1

README

Redmine MCP 服务器

这是一个用于 Redmine 的模型上下文协议 (MCP) 服务器实现。它与 Redmine 的 REST API 集成，为 LLM 提供工单和项目信息。

<a href="https://glama.ai/mcp/servers/55eg9u36cg"><img width="380" height="200" src="https://glama.ai/mcp/servers/55eg9u36cg/badge" alt="Redmine Server MCP server" /></a>

功能

支持来自 Redmine REST API 的稳定资源：

  • 问题 (1.0~)
  • 项目 (1.0~)
  • 用户 (1.1~)
  • 时间记录 (1.1~)

工具

问题

  • 搜索问题
    • 按项目、状态、经办人等筛选
    • 关键字搜索
    • 自定义字段支持
  • 创建/更新问题
    • 设置跟踪器、状态、优先级
    • 配置自定义字段
    • 添加评论
  • 删除问题

项目

  • 搜索项目
    • 按活动/已存档/已关闭状态筛选
    • 关键字搜索
  • 获取项目详情
    • 包括跟踪器、类别信息
  • 创建/更新项目
    • 配置模块和跟踪器
    • 设置成员继承
  • 存档/取消存档项目
  • 删除项目

时间记录

  • 搜索时间记录
    • 按项目、用户、日期范围筛选
  • 获取时间记录详情
  • 创建/更新时间记录
    • 针对项目或问题记录
    • 指定活动
    • 自定义字段支持
  • 删除时间记录

与 Claude 一起使用

要将此服务器与 Claude 一起使用，请按如下方式配置：

{
  "mcp-server-redmine": {
    "command": "npx",
    "args": [
      "-y",
      "--prefix",
      "/path/to/mcp-server-redmine",
      "mcp-server-redmine"
    ],
    "env": {
      "REDMINE_HOST": "https://your-redmine.example.com",
      "REDMINE_API_KEY": "your-api-key-here"
    }
  }
}

配置选项

  • command: 执行 npm 包的命令
  • args:
    • -y: 自动响应 "yes" 到提示
    • --prefix: 指定安装目录
    • 最后一个参数指定包名
  • env: 环境变量
    • REDMINE_HOST: Redmine 服务器 URL
    • REDMINE_API_KEY: 您的 Redmine API 密钥

设置

获取 API 密钥

  1. 在 Redmine 管理设置中启用 REST API
  2. 从用户设置页面获取 API 密钥

环境变量

设置以下环境变量：

  • REDMINE_API_KEY: 从 Redmine 用户设置获得的 API 密钥
  • REDMINE_HOST: Redmine 服务器 URL (例如，https://redmine.example.com)

测试

单元测试

# 运行测试
npm test

为了数据安全，测试中仅包含 GET 操作。

Inspector 测试

使用 MCP Inspector 验证功能：

# 构建
npm run build

# 设置执行权限 (重要)
chmod +x dist/index.js

# 启动 inspector
npx @modelcontextprotocol/inspector dist/index.js

权限

某些功能需要管理员权限：

用户相关操作

  • list_users: 需要管理员权限
  • create_user: 需要管理员权限
  • update_user: 需要管理员权限
  • delete_user: 需要管理员权限

可用信息因用户权限级别而异。有关详细信息，请参阅 Redmine API 文档。

开发

要求

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

库

  • @modelcontextprotocol/sdk: MCP SDK
  • zod: Schema 验证
  • typescript: 类型系统

目录结构

.
├── src/
│   ├── tools/            # 工具定义
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── formatters/       # 格式化器
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── lib/             # 通用库
│   │   ├── client.ts     # Redmine API 客户端
│   │   ├── config.ts     # 配置管理
│   │   └── types.ts      # 类型定义
│   ├── handlers.ts       # 请求处理程序
│   └── index.ts         # 入口点
├── docs/
│   └── adr/             # 架构决策记录
├── package.json         # 项目配置
├── tsconfig.json        # TypeScript 配置
└── README.md           # 文档

构建

# 安装依赖
npm install

# 构建
npm run build

# 启动开发服务器
npm run dev

架构决策记录

主要的設計決策記錄在 docs/adr 中。添加或修改功能時，請參考這些文檔。

许可证

MIT

相关项目

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
Gitingest-MCP

Gitingest-MCP

一个用于 gitingest 的 MCP 服务器。它允许像 Claude Desktop、Cursor、Cline 等 MCP 客户端快速提取关于 Github 仓库的信息，包括仓库摘要、项目目录结构、文件内容等。

精选
本地
Python
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python