redmine-mcp

Redmine の REST API を MCP (Model Context Protocol) の tool として公開するサーバーです。 Streamable HTTP と stdio の 2 つの transport に対応しています。

必要なもの

• Node.js 20 以上 (ローカル実行の場合)

• もしくは Docker / Docker Compose

• Redmine の REST API 有効化と API キー (Redmine の個人設定画面から取得)

Related MCP server: redmine-mcp-server

セットアップ

.env.sample をコピーして .env を作成し、REDMINE_URL と REDMINE_API_KEY を設定してください。

cp .env.sample .env

REDMINE_URL / REDMINE_API_KEY が未設定でも起動はしますが、tool 実行時にエラーになります。

起動

Docker Compose (HTTP transport)

docker compose up -d --build

ヘルスチェック:

curl http://127.0.0.1:${REDMINE_MCP_PORT:-3333}/healthz

停止:

docker compose down

ローカル実行

npm ci

# HTTP transport (.env を読み込む)
npm run start:env

# stdio transport
MCP_TRANSPORT=stdio npm start

MCP クライアント設定

Claude Code (HTTP)

claude mcp add --transport http redmine http://127.0.0.1:3333/mcp

Claude Code (stdio)

claude mcp add redmine -- node "$(pwd)/src/server.mjs"

stdio の場合は MCP_TRANSPORT=stdio と Redmine の接続情報を env として渡してください (.mcp.json.sample を参照)。

Codex (HTTP)

[mcp_servers.redmine]
url = "http://127.0.0.1:3333/mcp"
enabled = true
default_tools_approval_mode = "prompt"

公開している tool

一覧系の limit は既定 25 件、最大 100 件です。

添付ファイルの扱い

取得

redmine_download_attachment は添付の実体を返します。

• save_path を指定すると、そのパス (末尾 / や既存ディレクトリなら元のファイル名で配下) に保存し、保存先だけを返します。

• save_path なしの場合は MCP レスポンスに直接載せます。content type に応じて画像は image、テキストは text、その他は base64 の blob として返します (as で強制指定可)。

• インライン返却は REDMINE_MAX_INLINE_BYTES (既定 5MiB、max_bytes で上書き) を超えるとエラーになります。大きいファイルは save_path を使ってください。

添付の実体は Redmine が返す content_url から取得しますが、REDMINE_URL と同一オリジンでなければ取得を拒否します。

アップロード

redmine_upload_file は file_path / content_text / content_base64 のいずれか 1 つを受け取ります。

• issue_id を指定すると、アップロードしてそのままチケットへ添付します (notes で注記も同時に追加)。

• issue_id を省略するとアップロードトークンだけを返します。これを redmine_create_issue / redmine_update_issue の uploads に渡せば、チケット作成・更新と同時に添付できます。

• file_path は MCP サーバープロセスから見えるパスです。Docker で動かしている場合はコンテナ内のパスになる点に注意してください。

HTTP エンドポイント

構成

.
├── docker-compose.yml   # HTTP transport のコンテナ定義
├── Dockerfile
├── .env.sample
└── src/server.mjs       # MCP サーバー本体 (tool 定義 + transport)