Redmine MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Integrates with Redmine's REST API to provide ticket and project information to LLMs. Supports managing issues, projects, users, and time entries through the Redmine REST API.

Redmine MCP 서버

Redmine용 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. Redmine의 REST API와 통합되어 LLM에 티켓 및 프로젝트 정보를 제공합니다.

특징

Redmine REST API의 안정적인 리소스를 지원합니다.

  • 이슈 (1.0~)
  • 프로젝트(1.0~)
  • 사용자(1.1~)
  • 시간 항목(1.1~)

도구

문제

  • 검색 문제
    • 프로젝트, 상태, 담당자 등으로 필터링합니다.
    • 키워드 검색
    • 사용자 정의 필드 지원
  • 문제 생성/업데이트
    • 추적기, 상태, 우선순위 설정
    • 사용자 정의 필드 구성
    • 댓글 추가
  • 문제 삭제

프로젝트

  • 프로젝트 검색
    • 활성/보관/닫힘 상태별 필터링
    • 키워드 검색
  • 프로젝트 세부 정보 가져오기
    • 추적기, 카테고리 정보 포함
  • 프로젝트 생성/업데이트
    • 모듈 및 추적기 구성
    • 멤버 상속 설정
  • 프로젝트 보관/보관 취소
  • 프로젝트 삭제

시간 항목

  • 검색 시간 항목
    • 프로젝트, 사용자, 날짜 범위로 필터링
  • 시간 입력 세부 정보 가져오기
  • 시간 항목 생성/업데이트
    • 프로젝트 또는 문제에 대한 기록
    • 활동을 지정하세요
    • 사용자 정의 필드 지원
  • 시간 항목 삭제

Claude와 함께 사용

이 서버를 Claude와 함께 사용하려면 다음과 같이 구성하세요.

지엑스피1

구성 옵션

  • command : npm 패키지를 실행하는 명령
  • args :
    • -y : 프롬프트에 자동으로 "예"로 응답합니다.
    • --prefix : 설치 디렉토리 지정
    • 마지막 인수는 패키지 이름을 지정합니다.
  • env : 환경 변수
    • REDMINE_HOST : Redmine 서버 URL
    • REDMINE_API_KEY : Redmine API 키

설정

API 키 받기

  1. Redmine 관리자 설정에서 REST API 활성화
  2. 사용자 설정 페이지에서 API 키 가져오기

환경 변수

다음 환경 변수를 설정하세요.

  • REDMINE_API_KEY : Redmine 사용자 설정에서 얻은 API 키
  • REDMINE_HOST : Redmine 서버 URL (예: https://redmine.example.com )

테스트

단위 테스트

# Run tests npm test

데이터 안전을 위해 GET 작업만 테스트에 포함됩니다.

검사관 테스트

MCP Inspector를 사용하여 기능을 확인하세요.

# Build npm run build # Set execute permission (important) chmod +x dist/index.js # Launch inspector npx @modelcontextprotocol/inspector dist/index.js

권한

일부 기능을 사용하려면 관리자 권한이 필요합니다.

사용자 관련 작업

  • list_users : 관리자 권한이 필요합니다
  • create_user : 관리자 권한이 필요합니다
  • update_user : 관리자 권한이 필요합니다
  • delete_user : 관리자 권한이 필요합니다

사용 가능한 정보는 사용자 권한 수준에 따라 다릅니다. 자세한 내용은 Redmine API 문서를 참조하세요.

개발

요구 사항

  • Node.js 18 이상
  • npm 9 이상

도서관

  • @modelcontextprotocol/sdk : MCP SDK
  • zod : 스키마 검증
  • typescript : 타입 시스템

디렉토리 구조

. ├── src/ │ ├── tools/ # Tool definitions │ │ ├── issues.ts │ │ ├── projects.ts │ │ ├── time_entries.ts │ │ └── index.ts │ ├── formatters/ # Formatters │ │ ├── issues.ts │ │ ├── projects.ts │ │ ├── time_entries.ts │ │ └── index.ts │ ├── lib/ # Common libraries │ │ ├── client.ts # Redmine API client │ │ ├── config.ts # Configuration management │ │ └── types.ts # Type definitions │ ├── handlers.ts # Request handlers │ └── index.ts # Entry point ├── docs/ │ └── adr/ # Architecture Decision Records ├── package.json # Project configuration ├── tsconfig.json # TypeScript configuration └── README.md # Documentation

건물

# Install dependencies npm install # Build npm run build # Start development server npm run dev

아키텍처 결정 기록

주요 설계 결정 사항은 docs/adr 에 문서화되어 있습니다. 기능을 추가하거나 수정할 때 이 문서를 참조하세요.

특허

MIT

관련 프로젝트

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

REST API를 사용하여 Redmine과 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버로, LLM과 통합하여 티켓, 프로젝트 및 사용자 데이터를 관리할 수 있습니다.

  1. Features
    1. Tools
  2. Usage with Claude
    1. Configuration Options
  3. Setup
    1. Getting an API Key
    2. Environment Variables
  4. Testing
    1. Unit Tests
    2. Inspector Testing
  5. Permissions
    1. User-Related Operations
  6. Development
    1. Requirements
    2. Libraries
    3. Directory Structure
    4. Building
    5. Architecture Decision Records
  7. License
    1. Related Projects
      ID: 55eg9u36cg