redmine-mcp

셀프 호스팅 Redmine(redmine.dokkiitech.dev)을(를) Claude Code에서 조작하기 위한 MCP 서버(stdio)입니다.

설정

전제: uv가 설치되어 있어야 합니다.

1. Redmine의 API 키 발급

1. Redmine에 로그인

2. 오른쪽 위「내 계정」→ 오른쪽 사이드바「API 액세스 키」→「표시」

3. 표시된 키를 기록해 둡니다

2. Claude Code에 등록

claude mcp add --scope user redmine \
  --env REDMINE_API_KEY=<自分のAPIキー> \
  -- uvx --from git+https://github.com/dokkiitech/redmine-mcp redmine-mcp

등록 후, Claude Code를 재시작하면 redmine 서버가 연결됩니다. 확인은 claude mcp get redmine.

Related MCP server: Redmine MCP Server

환경 변수

제공 도구

주의

• Redmine 서버(EC2)는 0시~12시 JST에는 중지되어 있습니다. 연결 오류가 발생하면 가동 시간대(12시~24시 JST)인지 확인하세요

• Redmine의 REST API는 잘못된 값(존재하지 않는 커스텀 필드 ID 등)을 오류로 처리하지 않고 조용히 무시합니다. 업데이트 계열 작업 후에는 get_issue로 다시 읽어서 반영을 확인하는 것이 안전합니다

업데이트 반영

uvx는 git 리포지토리를 캐시합니다. 새 버전을 반영하려면:

uv cache clean redmine-mcp

개발

git clone https://github.com/dokkiitech/redmine-mcp
cd redmine-mcp
REDMINE_API_KEY=<key> uv run redmine-mcp  # stdio で起動(Ctrl+C で終了)

License

MIT