Redmine REST API에 대한 포괄적 인 액세스를 제공하는 Redmine 용 Model Context Protocol (MCP) 서버.

개요

이 프로젝트는 Redmine의 REST API를 종합적으로 다루는 MCP 서버입니다. 그것은 MCP 클라이언트 (클래드 데스크탑과 같은)에서 Redmine을 운영 할 수 있습니다.

데모

다음은 Claude Desktop과 Redmine MCP 서버를 사용하는 방법을 보여주는 비디오입니다.

문제 만들기

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

*이 데모는 Redmine MCP 서버와 함께 브라우저 자동화를위한 Playwright MCP를 사용합니다. *

이슈 정보 얻기

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

특징

• Comprehensive API 적용: Redmine의 REST API에서 모든 기능을 지원
• ♣Read-Only Mode**: 안전한 데이터 참조 모드 지원
• ☸ 도구 필터링: regex 패턴을 사용하여 도구를 사용할 수 있는 제어
• An️Tool Annotations: Declares readOnlyHint] 그래서 클라이언트는 쓰기에서 작업을 읽을 수 있습니다

필수품

Redmine API 키 받기

1. 관리자 권한으로 Redmine에 로그인
2. 명세.

Redmine MCP Server

Model Context Protocol (MCP) server for Redmine that provides comprehensive access to the Redmine REST API.

Overview

This project is an MCP server that comprehensively covers Redmine’s REST API. It allows you to operate Redmine from MCP clients (such as Claude Desktop).

Demonstration

Here are example videos showing how to use the Redmine MCP server with Claude Desktop:

Creating an Issue

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

This demonstration also uses the Playwright MCP for browser automation alongside the Redmine MCP server.

Getting Issue Information

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

Features

• 📋 Comprehensive API Coverage: Supports all functions available in Redmine’s REST API
• 🔒 Read-Only Mode: Supports safe data reference mode
• 🔧 Tool Filtering: Control which tools are available using regex patterns
• 🏷️ Tool Annotations: Declares readOnlyHint so clients can tell read operations from write ones

Prerequisites

Getting Redmine API Key

1. Log in to Redmine with administrator privileges
2. Go to “Administration” → “Settings” → “API” tab
3. Check “Enable REST web service”
4. Generate “API access key” in personal settings

For details, refer to Redmine REST API documentation.

Configuration

Environment Variables

The following environment variables are required (specified in MCP client configuration files):

• REDMINE_URL (Required): Base URL of the Redmine instance
  • Example: https://redmine.example.com
• REDMINE_API_KEY (Required): API key generated in Redmine
  • Set the API key obtained in prerequisites
• REDMINE_MCP_READ_ONLY (Optional): Enable read-only mode
  • true: Read-only mode (disables data modification operations)
  • false or unset: Allow all operations (default)
• REDMINE_MCP_TOOLS_ALLOW_PATTERN (Optional): Regex pattern to allow only matching tools
  • Example: ^get (enable only tools starting with “get”)
  • If unset, all tools are allowed (subject to other settings)
• REDMINE_MCP_TOOLS_DENY_PATTERN (Optional): Regex pattern to disable matching tools
  • Example: ^delete (disable all tools starting with “delete”)
  • If unset, no tools are denied (subject to other settings)
  • Deny pattern takes priority over allow pattern

MCP Client Configuration

Using npx (Recommended for quick start)

Add the following as MCP configuration for your AI agent:

{
  "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"
      }