redmine-mcp-server

redmine-mcp-server は、公式 Redmine REST API を MCP ツール、リソース、プロンプトとして公開する Python 製の外部アダプタです。Redmine プラグインではありません。

このリポジトリの狙いは、Claude Code や各種 MCP ホストから、Redmine のプロジェクト発見、課題検索、詳細参照、時間記録、Wiki 操作を安全で型付きのインターフェースで扱えるようにすることです。

特徴

Python 実装
公式 MCP Python SDK を利用
stdio transport を v1 の主対象に採用
Redmine とは HTTP(S) のみで連携
read/write/admin の境界を feature flag で制御
Redmine 生 JSON をそのまま返さず、LLM 向けに整形した出力を返す

サポート対象

Python: 3.11+
主対象: Python 3.12
Redmine: 5.0+
MCP protocol target: 2025-11-25
v1 transport: stdio

主要ツール

読み取り:

whoami
list_projects
get_project
list_queries
search_issues
get_issue
list_issue_statuses
list_trackers
list_priorities
list_time_entry_activities
list_time_entries
get_wiki_page
list_wiki_pages
get_attachment_metadata

書き込み系は REDMINE_ENABLE_WRITE_TOOLS=true のときだけ登録されます:

create_issue
update_issue
add_issue_note
create_time_entry
update_time_entry
upsert_wiki_page
delete_wiki_page
upload_attachment
create_issue_with_attachments
update_issue_with_attachments

管理系は REDMINE_ENABLE_ADMIN_TOOLS=true のときだけ登録されます:

list_users
get_user

セットアップ

uv sync --extra dev

起動:

uv run redmine-mcp-server

設定

REDMINE_BASE_URL=https://redmine.example.com
REDMINE_API_KEY=
REDMINE_USERNAME=
REDMINE_PASSWORD=
REDMINE_TIMEOUT_MS=30000
REDMINE_VERIFY_TLS=true
REDMINE_ENABLE_WRITE_TOOLS=false
REDMINE_ENABLE_ADMIN_TOOLS=false
REDMINE_DEFAULT_LIMIT=25
REDMINE_MAX_LIMIT=100
REDMINE_USER_AGENT=redmine-mcp-server/0.1
MCP_TRANSPORT=stdio
MCP_HTTP_HOST=127.0.0.1
MCP_HTTP_PORT=8787
MCP_HTTP_PATH=/mcp
MCP_PROTOCOL_VERSION=2025-11-25
LOG_LEVEL=INFO

認証は X-Redmine-API-Key を優先し、未指定の場合は Basic 認証を使います。公開 Redmine を匿名で読む場合のみ REDMINE_ALLOW_ANONYMOUS_READ=true を使えます。

Claude Desktop 例

例は examples/claude_desktop/config.json に置いてあります。概形は以下です。

{
  "mcpServers": {
    "redmine": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/redmine-mcp-server",
        "run",
        "redmine-mcp-server"
      ],
      "env": {
        "REDMINE_BASE_URL": "https://redmine.example.com",
        "REDMINE_API_KEY": "your-api-key",
        "REDMINE_ENABLE_WRITE_TOOLS": "false"
      }
    }
  }
}

セキュリティ

write tools はデフォルトで無効です
admin tools はデフォルトで無効です
秘密情報はログに出しません
stdio 実行時、ログは stderr にのみ出します
添付ファイルはトークン方式です。upload_attachment でトークンを作り、create_issue_with_attachments / update_issue_with_attachments に明示的に渡します

開発

uv run ruff check .
uv run ruff format --check .
uv run pyright
uv run pytest

構成

docs/architecture/SSOT.md: 最上位仕様
docs/api/tool_contracts.md: MCP 公開契約の要約
src/redmine_mcp_server/mcp_app/: MCP presentation layer
src/redmine_mcp_server/redmine/: Redmine adapter layer
src/redmine_mcp_server/domain/: normalized domain layer
tests/: unit と mocked integration tests

ライセンス

MIT

このリポジトリは MIT で公開できますが、利用者は接続先 Redmine 環境に適用されるライセンスや利用規約を別途確認する必要があります。

MCP Servers