AI导哈

Redmine MCP Server

Redmine MCP Server 是一个用于从编码代理（如Claude Code）直接操作Redmine票务的服务。

  • by kazuabe
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 kazuabe/mcp-redmine

使用说明

Redmine MCP服务器

用于直接从编码代理（Claude Code等）操作Redmine票证的MCP Server。

提供工具列表

票证操作

工具名称｜说明｜ |---------|------| | list_issues ｜票证一览取得（可由项目、状态、负责人等过滤）｜ | get_issue 获取票证详细信息（包括评论历史记录、附件等相关信息） | search_issues 基于关键字的票证检索 | create_issue 新建票证 | update_issue ｜票证更新（状态变更、负责人变更等）｜ | add_comment 添加对票证的评论 | bulk_update_issues 多票批量更新

项目名称

工具名称｜说明｜ |---------|------| | list_projects 获取项目列表 | get_project 获取项目详细信息

主数据参照

工具名称｜说明｜ |---------|------| | list_statuses 状态列表 | list_trackers 跟踪器列表 | list_priorities |优先度一覧| | list_users 用户列表（需要管理员权限）

维基

工具名称｜说明｜ |---------|------| | list_wiki_pages 获取项目维客页面列表 | get_wiki_page 获取维客页面内容 | get_ticket_rules 获取票证开票规则（TicketRules页面）

开票规则的运用方法在项目维客中TicketRules创建页面时，代理将在创建票证之前浏览规则。详细说明 docs/wiki-convention.md 来修改标记元素的显示属性。

安装，安装

方法1: Docker（推奨）

无需安装Python或uv。

docker build -t redmine-mcp-server .

Claude Code中的设置示例（Docker）

.claude/settings.json:

{
  "mcpServers": {
    "redmine": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "REDMINE_URL", "-e", "REDMINE_API_KEY", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine.example.com",
        "REDMINE_API_KEY": "your-api-key"
      }
    }
  }
}

方法2:本地执行

必要环境

  • Python 3.12+
  • 紫外线
  • 启用REST API的Redmine环境

安装

uv sync

Claude Code中的设置示例（本地）

.claude/settings.json:

{
  "mcpServers": {
    "redmine": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-redmine", "python", "main.py"],
      "env": {
        "REDMINE_URL": "https://your-redmine.example.com",
        "REDMINE_API_KEY": "your-api-key"
      }
    }
  }
}

环境变数

变数名 必须 说明
REDMINE_URL ｜是｜Redmine的基本URL｜
REDMINE_API_KEY 是：Redmine的API密钥（个人设置→从API访问密钥获取）
MCP_TRANSPORT ｜否｜传输种类： stdio（默认）或 sse
MCP_HOST ｜否｜SSE时的主机（默认值： 0.0.0.0）
MCP_PORT ｜否｜SSE时的端口（默认值： 8000）

SSE传输

可以通过SSE（Server-Sent Events）传输启动，而不是stdio。

# SSEモードで起動
REDMINE_URL=https://your-redmine.example.com REDMINE_API_KEY=your-key MCP_TRANSPORT=sse uv run python main.py
# → http://localhost:8000/sse でアクセス可能

要更改主机或端口：

MCP_TRANSPORT=sse MCP_HOST=127.0.0.1 MCP_PORT=3000 uv run python main.py

相关 MCP