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。

環境変数

変数	必須	説明
REDMINE_API_KEY	✔	Redmine の API アクセスキー(各自発行)
REDMINE_URL	-	接続先(既定: https://redmine.dokkiitech.dev)

提供ツール

ツール	説明
list_projects	プロジェクト一覧
list_issues	チケット一覧(プロジェクト・ステータス・担当者・件名で絞り込み)
get_issue	チケット詳細(コメント履歴・添付込み)
create_issue	チケット作成
update_issue	チケット更新(コメント追加・ステータス変更・進捗率など)
search	全文検索(チケット・Wiki・ニュース等)
list_metadata	トラッカー / ステータス / 優先度 / ユーザーの ID 一覧

注意

• 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