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