AI导哈

Redmine 项目管理 MCP 服务

Redmine MCP Server 是一个通过模型上下文协议（MCP）将 AI 助手接入 Redmine 的项目管理服务，支持问题跟踪、项目版本、工时记录、Wiki 和文件管理，适用于需要利用 AI 自动完成 Redmine 协作与开发流程的团队。

  • by gmlee-ncurity
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gmlee-ncurity/redmine-mcp-server

使用说明

Redmine MCP Server

한국어 | Usage Guide | Contributing

A Model Context Protocol (MCP) server for Redmine. Enables AI assistants to manage issues, projects, time tracking, wiki pages, files, and more.

Quick Start

Stdio (Claude Desktop / VS Code)

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["-y", "@gmlee-ncurity/mcp-server-redmine"],
      "env": {
        "REDMINE_URL": "https://your-redmine.com",
        "REDMINE_API_KEY": "your-api-key"
      }
    }
  }
}

HTTP (Claude Code / Multi-user)

REDMINE_URL=https://your-redmine.com npm run start:http
claude mcp add --transport http redmine http://localhost:3000/mcp
# Browser opens → Enter Redmine API Key → Done

See USAGE.md for detailed configuration, Docker deployment, and reverse proxy setup.

Features

  • Issues — List, create, update, delete, search with filters
  • Projects — List, view details, versions/milestones
  • Time Tracking — Log entries, manage records, list activities
  • Users — List, get details, current user info
  • Wiki — List, create, update, delete pages
  • Files & Attachments — Upload, list, manage files and attachments
  • Journals — Update notes
  • Utilities — Statuses, priorities, trackers, custom API requests, search
  • Issue links — Server instructions tell the assistant to build issue links from REDMINE_URL (<REDMINE_URL>/issues/<id>), so it does not guess the host

Available Tools

Category Tools
Issues list_issues, get_issue, create_issue, update_issue, delete_issue
Projects list_projects, get_project, get_project_versions
Users list_users, get_current_user, get_user
Time Entries list_time_entries, get_time_entry, create_time_entry, update_time_entry, delete_time_entry, list_time_entry_activities
Wiki list_wiki_pages, get_wiki_page, create_or_update_wiki_page, delete_wiki_page
Journals update_journal
Attachments get_attachment, update_attachment, delete_attachment
Files list_files, create_file, upload_file
Utilities list_statuses, list_priorities, list_trackers, custom_request, search

All tools are prefixed with redmine_ (e.g., redmine_list_issues).

Breaking Changes

redmine_get_issue — Comments Now Opt-in

Issue comments are no longer returned by default. To retrieve comments, use one of:

  • include_journals=true — returns comments with pagination control via journals_limit, journals_offset, journals_order
  • include: ["journals"] — same effect, unless include_journals is explicitly set to false

For details and new pagination parameters, see docs/API.md.

Installation

# Direct usage (no install)
npx @gmlee-ncurity/mcp-server-redmine

# Global install
npm install -g @gmlee-ncurity/mcp-server-redmine

License

Apache License 2.0 — see LICENSE for details.

相关 MCP