星战科技xingzhan.cloud
返回市场
红矿-MCP服务器

红矿-MCP服务器

作者：onozaty5 星标更新：2025-11-09
安装使用来源：spider==github.com

项目介绍

Redmine MCP Server

这是一个用于Redmine的模型上下文协议（MCP）服务器，提供了对Redmine REST API的全面访问。

概述

该项目是一个MCP服务器，全面覆盖了Redmine的REST API。它允许您通过MCP客户端（如Claude Desktop）操作Redmine。

演示

这里有一些视频示例，展示了如何使用Redmine MCP服务器与Claude Desktop：

创建问题

https://github.com/user-attachments/assets/075fb079-104c-404d-91f5-755b3882853b

此演示还使用了Playwright MCP，用于浏览器自动化，以及Redmine MCP服务器。

获取问题信息

https://github.com/user-attachments/assets/8f551082-6982-4513-8fe7-b0f111be982d

特性

  • 📋 全面API支持：支持Redmine REST API中的所有功能
  • 🔒 只读模式：支持安全的数据引用模式

预备条件

获取Redmine API密钥

  1. 使用管理员权限登录Redmine
  2. 前往“管理”→“设置”→“API”标签页
  3. 启用“REST Web服务”
  4. 在个人设置中生成“API访问密钥”

详情请参阅Redmine REST API文档。

配置

环境变量

需要以下环境变量（在MCP客户端配置文件中指定）：

  • REDMINE_URL（必需）：Redmine实例的基本URL
    • 示例：https://redmine.example.com
  • REDMINE_API_KEY（必需）：在Redmine中生成的API密钥
    • 设置在预备条件中获取的API密钥
  • REDMINE_MCP_READ_ONLY（可选）：启用只读模式
    • true：只读模式（禁用数据修改操作）
    • false或未设置：允许所有操作（默认）

MCP客户端配置

使用npx（推荐快速启动）

为您的AI代理添加如下MCP配置：

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine.example.com",
        "REDMINE_API_KEY": "your-api-key-here",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

使用Docker（替代方案）

如果您更喜欢使用Docker：

{
  "mcpServers": {
    "redmine": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "REDMINE_URL=https://your-redmine.example.com",
        "-e", "REDMINE_API_KEY=your-api-key-here",
        "-e", "REDMINE_MCP_READ_ONLY=true",
        "ghcr.io/onozaty/redmine-mcp-server:latest"
      ]
    }
  }
}

何时使用Docker：

  • 需要容器隔离的企业环境
  • 不同系统上的可重复部署
  • 限制Node.js安装的环境

以下是几种MCP客户端的具体配置方法：

Claude Desktop

在claude_desktop_config.json中添加如下内容：

{
  "mcpServers": {
    "redmine": {
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine.example.com",
        "REDMINE_API_KEY": "your-api-key-here",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

Claude Code

在Claude Code中，您可以使用以下命令添加MCP服务器：

本地配置：

claude mcp add redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server

项目配置：

claude mcp add -s project redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=
your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server

用户配置（全局）：

claude mcp add -s user redmine -e REDMINE_URL=https://your-redmine.example.com -e REDMINE_API_KEY=your-api-key-here -e REDMINE_MCP_READ_ONLY=true -- npx -y @onozaty/redmine-mcp-server

Visual Studio Code

项目配置（.vscode/mcp.json）：

{
  "servers": {
    "redmine": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://your-redmine.example.com",
        "REDMINE_API_KEY": "your-api-key-here",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

用户配置（settings.json）：

{
  "mcp": {
    "servers": {
      "redmine": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@onozaty/redmine-mcp-server"],
        "env": {
          "REDMINE_URL": "https://your-redmine.example.com",
          "REDMINE_API_KEY": "your-api-key-here",
          "REDMINE_MCP_READ_ONLY": "true"
        }
      }
    }
  }
}

可用特性

此MCP服务器全面支持Redmine REST API提供的功能：

主要功能

  • 问题：创建、更新、删除、搜索及管理相关问题
  • 项目：创建、更新、删除、归档及管理成员资格
  • 用户：创建、更新、删除及管理组
  • 时间条目：记录、更新及删除时间条目
  • 维基：创建、更新、删除页面及管理版本
  • 新闻：创建、更新及删除新闻
  • 文件：上传和下载文件
  • 附件：上传、下载文件及获取缩略图
  • 查询：执行保存的查询
  • 自定义字段：获取及管理自定义字段
  • 角色：获取及管理角色
  • 跟踪器：获取及管理跟踪器
  • 问题状态：获取及管理问题状态
  • 搜索：跨搜索功能

只读模式

通过设置REDMINE_MCP_READ_ONLY=true，可以禁用数据修改操作。这允许安全的数据引用。

许可证

MIT许可证

作者

onozaty

致谢