Redmine 的 MCP 服务器。使 AI 代理能够通过简单的自然语言命令处理问题。

作为单个开发者的个人工具同样有效——或者一次性部署后由 整个团队。

💬 直接问

“分配给我的是什么问题？按优先级排序。”

“在网页项目中创建错误：登录按钮在移动端无响应，标记为紧急。”

“总结第#456号及其所有子任务。”

“我这周按项目划分了多少小时？”

要求

• Node.js 22+
• 启用REST API的Redmine实例（Administration →设置→ API）
• Redmine API 密钥 — 登录时前往 我的账户 → API 访问密钥

快速开始

大多数MCP客户端（例如Claude Desktop）会帮你启动服务器——配置一次就忘了：

对于Claude Desktop，这部分可以放到claude_desktop_config.json（设置→开发者→编辑 配置）。重启客户端后，Redmine工具会出现在工具列表中。

如果想从壳体独立运行：

服务器通过stdio使用MCP通信，并日志到stderr，所以stdout在协议中保持干净。

配置

通过环境变量设置，启动时验证。参见 '.env.

🦎 Agama — Redmine MCP Server

MCP server for Redmine. Enables AI agents to work with issues using simple natural language commands.

Works just as well as a personal tool for a single developer — or deployed once and shared by the whole team.

┌──────────┐   MCP (stdio)   ┌─────────────────────┐   REST/JSON   ┌──────────┐
│  Agent   │ ──────────────▶ │  Redmine MCP Server │ ────────────▶ │ Redmine  │
│ (client) │ ◀────────────── │   (this project)    │ ◀──────────── │  server  │
└──────────┘   tool results  └─────────────────────┘     HTTP      └──────────┘

💬 Just ask

“What issues are assigned to me? Sort them by priority.”

“Create a bug in the Web project: login button doesn’t respond on mobile, mark it urgent.”

“Summarize issue #456 and all its subtasks.”

“How many hours did I log this week, broken down by project?”

Requirements

• Node.js 22+
• A Redmine instance with the REST API enabled (Administration → Settings → API)
• A Redmine API key — go to My account → API access key while signed in

Quick start

Most MCP clients (e.g. Claude Desktop) launch the server for you — configure it once and forget it:

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["-y", "@0xkillaflow/agama-redmine-mcp"],
      "env": {
        "REDMINE_URL": "https://redmine.example.com",
        "REDMINE_API_KEY": "your-redmine-api-key"
      }
    }
  }
}

For Claude Desktop, this goes in claude_desktop_config.json (Settings → Developer → Edit Config). Restart the client and the Redmine tools will appear in its tool list.

To run it standalone from a shell instead:

REDMINE_URL=https://redmine.example.com REDMINE_API_KEY=your-redmine-api-key \
  npx -y @0xkillaflow/agama-redmine-mcp

The server speaks MCP over stdio and logs to stderr, so stdout stays clean for the protocol.

Configuration

Set via environment variables, validated at startup. See .env.example for a