Redmine MCP 서버

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

특징

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

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

도구

문제

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

프로젝트

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

시간 항목

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

Related MCP server: MCP Ethers Wallet

Claude와 함께 사용

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

지엑스피1

구성 옵션

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

설정

API 키 받기

Redmine 관리자 설정에서 REST API 활성화
사용자 설정 페이지에서 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

Redmine MCP Server