Redmine의 모델 Context Protocol (MCP) 서버 구현입니다. Redmine의 REST API와 통합하여 티켓 및 프로젝트 정보를 LLMs에 제공합니다.

특징

Redmine REST API의 안정적인 리소스 지원:

• 문제 (1.0~)
• 프로젝트 (1.0~)
• 사용자 (1.1~)
• 시간 문의 (1.1~)

도구

문제

• 검색 문제
• 프로젝트, 상태, 할당자 등에 의한 필터
• 키워드 검색
• 사용자 정의 필드 지원
• 생성/업데이트 문제
• 추적기, 상태, 우선 설정
• 사용자 정의 필드 구성
• 코멘트 추가
• 문제 삭제

프로젝트

• 검색 프로젝트
• 활성/archived/닫힌 상태에 의한 필터
• 키워드 검색
• 프로젝트 상세보기
• 추적기, 범주 정보 포함
• Create/Update 프로젝트
• 모듈 및 추적기 구성
• 회원 상속 설정
• Archive/Unarchive 프로젝트
• 프로젝트 삭제

시간 항목

• 검색 시간 항목
• 프로젝트별로 필터, 사용자, 날짜 범위
• Time Entry 세부 정보 얻기
• Create/Update 시간 항목
• 프로젝트 또는 문제점에 대한 기록
• 지정 활동
• 사용자 정의 필드 지원
• 시간 삭제

Claude와 사용

Claude를 사용하여이 서버를 사용하려면 다음과 같이 구성하십시오.

구성 옵션

Redmine MCP Server

This is a Model Context Protocol (MCP) server implementation for Redmine. It integrates with Redmine’s REST API to provide ticket and project information to LLMs.

Features

Supports stable resources from Redmine REST API:

• Issues (1.0~)
• Projects (1.0~)
• Users (1.1~)
• Time Entries (1.1~)

Tools

Issues

• Search Issues
  • Filter by project, status, assignee, etc.
  • Keyword search
  • Custom field support
• Create/Update Issues
  • Set tracker, status, priority
  • Configure custom fields
  • Add comments
• Delete Issues

Projects

• Search Projects
  • Filter by active/archived/closed status
  • Keyword search
• Get Project Details
  • Include trackers, categories information
• Create/Update Projects
  • Configure modules and trackers
  • Set member inheritance
• Archive/Unarchive Projects
• Delete Projects

Time Entries

• Search Time Entries
  • Filter by project, user, date range
• Get Time Entry Details
• Create/Update Time Entries
  • Record against project or issue
  • Specify activity
  • Custom field support
• Delete Time Entries

Usage with Claude

To use this server with Claude, configure it as follows:

{
  "mcp-server-redmine": {
    "command": "npx",
    "args": [
      "-y",
      "--prefix",
      "/path/to/mcp-server-redmine",
      "mcp-server-redmine"
    ],
    "env": {
      "REDMINE_HOST": "https://your-redmine.example.com",
      "REDMINE_API_KEY": "your-api-key-here"
    }
  }
}

Configuration Options

• command: Command to execute the npm package
• args:
  • -y: Auto-respond “yes” to prompts
  • --prefix: Specify installation directory
  • Last argument specifies the package name
• env: Environment variables
  • REDMINE_HOST: Redmine server URL
  • REDMINE_API_KEY: Your Redmine API key

Setup

Getting an API Key

1. Enable REST API in Redmine admin settings
2. Get API key from user settings page

Environment Variables

Set the following environment variables:

• REDMINE_API_KEY: API key obtained from Redmine user settings
• REDMINE_HOST: Redmine server URL (e.g., https://redmine.example.com)

Testing

Unit Tests

# Run tests
npm test

For data safety, only GET operations are included in tests.

Inspector Testing

Use MCP Inspector to verify functionality.

Use MCP Inspector to verify functionality.

GUI Mode

# Build
npm run build

# Set execute permission (important)
chmod +x dist/index.js

# Launch inspector
npx @modelcontextprotocol/inspector dist/index.js