Redmine MCP 서버

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

특징

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

• 이슈 (1.0~)

• 프로젝트(1.0~)

• 사용자(1.1~)

• 시간 항목(1.1~)

도구

문제

• 검색 문제

  • 프로젝트, 상태, 담당자 등으로 필터링합니다.

  • 키워드 검색

  • 사용자 정의 필드 지원

• 문제 생성/업데이트

  • 추적기, 상태, 우선순위 설정

  • 사용자 정의 필드 구성

  • 댓글 추가

• 문제 삭제

프로젝트

• 프로젝트 검색

  • 활성/보관/닫힘 상태별 필터링

  • 키워드 검색

• 프로젝트 세부 정보 가져오기

  • 추적기, 카테고리 정보 포함

• 프로젝트 생성/업데이트

  • 모듈 및 추적기 구성

  • 멤버 상속 설정

• 프로젝트 보관/보관 취소

• 프로젝트 삭제

시간 항목

• 검색 시간 항목

  • 프로젝트, 사용자, 날짜 범위로 필터링

• 시간 입력 세부 정보 가져오기

• 시간 항목 생성/업데이트

  • 프로젝트 또는 문제에 대한 기록

  • 활동을 지정하세요

  • 사용자 정의 필드 지원

• 시간 항목 삭제

Related MCP server: Redmine MCP Server

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

관련 프로젝트

• 모델 컨텍스트 프로토콜

• MCP 타입스크립트 SDK

• 레드마인