Skip to main content
Glama
deenesjakoruzh
suryamalempati

Redmine MCP Server

by suryamalempati
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Redmine MCP 服务器

一个 MCP（模型上下文协议）服务器，将 Kiro 等 AI 助手连接到您的 Redmine 实例。它提供 15 个工具，涵盖问题（Issues）、项目（Projects）和搜索（Search）——让您的 AI 助手能够通过自然对话创建问题、更新项目、跨资源搜索等。

功能说明

配置完成后，您可以向 AI 助手提出类似这样的请求：

  • "列出分配给我的所有未解决问题"

  • "为登录页面崩溃创建一个缺陷报告"

  • "搜索与数据库迁移相关的问题"

  • "归档 old-website 项目"

  • "将 John 添加为问题 #42 的观察者"

服务器会自动处理身份验证、分页、输入验证和错误处理。

Related MCP server: @a-bonus/redmine-mcp

可用工具

领域

工具

问题

列表、获取、创建、更新、删除、添加观察者、移除观察者

项目

列表、获取、创建、更新、删除、归档、取消归档

搜索

跨所有 Redmine 资源的全文搜索

前提条件

  1. 机器上已安装 Python 3.10+

  2. uv —— 一个快速的 Python 包管理器（安装指南）

    • macOS/Linux：curl -LsSf https://astral.sh/uv/install.sh | sh

    • Windows：powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  3. Redmine API 密钥 —— 从您的 Redmine 实例获取：

    • 登录 Redmine

    • 进入 我的账户（右上角菜单）

    • 在右侧边栏中找到 API 访问密钥，点击 显示

    • 复制该密钥

使用 Kiro 进行设置

步骤 1：将 MCP 服务器配置添加到 Kiro

创建或编辑 ~/.kiro/settings/mcp.json（这样它将在您的所有项目中可用）：

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/bizcloud-experts/redmine-mcp-server.git", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

替换：

  • 将 https://your-redmine-instance.com 替换为您的 Redmine URL

  • 将 your-api-key-here 替换为您的 Redmine API 密钥

如果您只想在特定工作区中使用，也可以将其放在该工作区内的 .kiro/settings/mcp.json 中。

步骤 2：打开 Kiro

MCP 服务器将在 Kiro 启动时自动运行。您可以通过询问"列出我的 Redmine 项目"来验证它是否正常工作。

备选方案：如果未安装 git

如果您遇到"Git executable not found"错误，可以使用基于 zip 的安装方式，这种方式不需要在机器上安装 git：

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "redmine-mcp-server @ https://github.com/bizcloud-experts/redmine-mcp-server/archive/refs/heads/main.zip", "redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

备选设置：本地安装

如果您希望从本地克隆运行而不是使用 uvx：

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install .

然后改用以下 MCP 配置：

{
  "mcpServers": {
    "redmine": {
      "command": "/absolute/path/to/redmine-mcp/.venv/bin/redmine-mcp-server",
      "args": [],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.com",
        "REDMINE_API_KEY": "your-api-key-here"
      },
      "disabled": false
    }
  }
}

故障排查

问题

解决方案

"REDMINE_URL environment variable is missing"

确保在 MCP 配置的 env 块中设置了 REDMINE_URL

"REDMINE_API_KEY environment variable is missing"

确保在 MCP 配置的 env 块中设置了 REDMINE_API_KEY

"Authentication failed: invalid or expired API key"

验证您的 API 密钥在 Redmine → 我的账户 → API 访问密钥中是否正确

"Connection failed"

检查从您的机器是否可以访问 REDMINE_URL

工具未出现在 Kiro 中

确认 mcp.json 文件位于正确位置，且 "disabled" 为 false

"Git executable not found"

Git 未安装或不在 PATH 中。请改用基于 zip 的安装，或安装 git 后重启终端

开发

git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest

This server cannot be installed

F
license - not found
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • PlanExe

    MCP server for generating rough-draft project plans from natural-language prompts.

  • mcp-aichat

    MCP server for AI dialogue using various LLM models via AceDataCloud

  • Danushkumar-V-mcp-discord

    An MCP server that integrates with Discord to provide AI-powered features.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/suryamalempati/redmine-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server