Redmine MCP Server
Redmine MCP Server
Redmine インスタンスに Kiro などの AI アシスタントを接続する MCP (Model Context Protocol) サーバーです。Issues・Projects・Search をカバーする 15 のツールを公開しており、AI アシスタントが自然な会話を通じて、issue の作成、プロジェクトの更新、リソースの検索などを行うことができます。
機能
設定が完了すると、AI アシスタントに次のような依頼ができるようになります:
「自分に割り当てられた未完了の issue をすべて一覧表示して」
「ログインページのクラッシュのバグレポートを作成して」
「データベース移行に関連する issue を検索して」
「old-website プロジェクトをアーカイブして」
「issue #42 のウォッチャーに John を追加して」
サーバーは認証、ページネーション、入力検証、エラーハンドリングを自動的に処理します。
Related MCP server: @a-bonus/redmine-mcp
利用可能なツール
ドメイン | ツール |
Issues | list, get, create, update, delete, add watcher, remove watcher |
Projects | list, get, create, update, delete, archive, unarchive |
Search | すべての Redmine リソースにわたる全文検索 |
前提条件
Python 3.10+ がマシンにインストールされていること
uv — 高速な Python パッケージマネージャー(インストールガイド)
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Redmine API キー — Redmine インスタンスから取得します:
Redmine にログイン
右上のメニューから My Account に移動
右サイドバーの API access key を見つけて Show をクリック
キーをコピー
Kiro でのセットアップ
ステップ 1: MCP サーバー設定を Kiro に追加
~/.kiro/settings/mcp.json を作成または編集します(これにより、すべてのプロジェクトで利用できるようになります):
{
"mcpServers": {
"redmine": {
"command": "uvx",
"args": ["--from", "git+https://github.com/bizcloud-experts/redmine-mcp-server.git", "redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine-instance.com",
"REDMINE_API_KEY": "your-api-key-here"
},
"disabled": false
}
}
}置き換えるもの:
https://your-redmine-instance.comを Redmine の URL にyour-api-key-hereを Redmine の API キーに
特定のワークスペースだけで利用したい場合は、そのワークスペース内の .kiro/settings/mcp.json に配置することもできます。
ステップ 2: Kiro を開く
Kiro を起動すると、MCP サーバーが自動的に起動します。「Redmine プロジェクトを一覧表示して」と尋ねて動作を確認できます。
代替方法: git がインストールされていない場合
「Git executable not found」エラーが発生する場合は、マシンに git を必要としない zip ベースのインストールを使用できます:
{
"mcpServers": {
"redmine": {
"command": "uvx",
"args": ["--from", "redmine-mcp-server @ https://github.com/bizcloud-experts/redmine-mcp-server/archive/refs/heads/main.zip", "redmine-mcp-server"],
"env": {
"REDMINE_URL": "https://your-redmine-instance.com",
"REDMINE_API_KEY": "your-api-key-here"
},
"disabled": false
}
}
}代替セットアップ: ローカルインストール
uvx の代わりにローカルクローンから実行したい場合:
git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install .代わりに次の MCP 設定を使用します:
{
"mcpServers": {
"redmine": {
"command": "/absolute/path/to/redmine-mcp/.venv/bin/redmine-mcp-server",
"args": [],
"env": {
"REDMINE_URL": "https://your-redmine-instance.com",
"REDMINE_API_KEY": "your-api-key-here"
},
"disabled": false
}
}
}トラブルシューティング
問題 | 解決策 |
"REDMINE_URL environment variable is missing" | MCP 設定の |
"REDMINE_API_KEY environment variable is missing" | MCP 設定の |
"Authentication failed: invalid or expired API key" | Redmine → My Account → API access key で API キーが正しいか確認してください |
"Connection failed" | お使いのマシンから |
Kiro にツールが表示されない |
|
"Git executable not found" | Git がインストールされていないか、PATH が通っていません。代わりに zip ベースのインストール を使用するか、git をインストールしてターミナルを再起動してください |
開発
git clone https://github.com/bizcloud-experts/redmine-mcp-server.git
cd redmine-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytestAvailable Tools
17 toolsadd_watcherAdd WatcherC
Add a watcher to an issue.
Inputs: user_id (required), issue_id (required). Returns: object
archive_projectArchive ProjectC
Archive a project.
Inputs: project_id (required). Returns: object
create_issueCreate IssueC
Create a new issue in a project.
Inputs: subject (required), project_id (required), status_id, done_ratio, +11 more. Returns: object
create_projectCreate ProjectD
Create a new project.
Inputs: name (required), identifier (required), homepage, is_public, +9 more. Returns: object
delete_issueDelete IssueC
Delete an issue permanently.
Inputs: issue_id (required). Returns: object
delete_projectDelete ProjectC
Delete a project permanently.
Inputs: project_id (required). Returns: object
get_issueGet IssueC
Get detailed information about a specific issue.
Inputs: issue_id (required), include. Returns: object
get_projectGet ProjectC
Get detailed information about a specific project.
Inputs: project_id (required), include. Returns: object
get_time_entryGet Time EntryC
Get detailed information about a specific time entry.
Inputs: time_entry_id (required). Returns: object
list_issuesList IssuesC
List issues with optional filters and pagination.
Inputs: sort, limit, offset, fetch_all, +6 more. Returns: object
list_projectsList ProjectsB
List all accessible projects with pagination.
Inputs: limit, offset, include. Returns: object
list_time_entriesList Time EntriesB
List time entries with optional filters and pagination.
Inputs: limit, offset, to_date, user_id, +4 more. Returns: object
remove_watcherRemove WatcherC
Remove a watcher from an issue.
Inputs: user_id (required), issue_id (required). Returns: object
searchSearchD
Search across Redmine resources.
Inputs: query (required), news, limit, scope, +10 more. Returns: object
unarchive_projectUnarchive ProjectC
Unarchive a project.
Inputs: project_id (required). Returns: object
update_issueUpdate IssueD
Update an existing issue.
Inputs: issue_id (required), notes, subject, due_date, +15 more. Returns: object
update_projectUpdate ProjectC
Update an existing project.
Inputs: project_id (required), name, homepage, is_public, +9 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools target a distinct resource+action pair (issues, projects, watchers, time entries), making boundaries clear. The generic 'search' tool mildly overlaps with filtered list_issues/list_projects, but descriptions keep them separable.
Every tool follows a strict verb_noun convention: list_/get_/create_/update_/delete_/add_/remove_/archive_/unarchive_ plus a clear resource noun. Highly predictable with no deviations.
17 tools sits at the heavier end of the range but is justified by covering multiple resources: full issue CRUD, project CRUD plus archive/unarchive, watchers, and time entries. Nothing feels redundant.
Issues and projects have full lifecycle coverage including archive/unarchive and watchers. Time entries only support read (list/get) with no create/update/delete, a notable gap for a time-tracking-centric tool like Redmine.
Maintenance
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server for AI dialogue using various LLM models via AceDataCloud
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that integrates with Discord to provide AI-powered features.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Redmine issues, projects, time tracking, wiki, and files via the MCP protocol.3325 npm6Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server for Redmine that enables interaction with issues, wiki pages, and time entries through natural language.ISC
- AlicenseAqualityCmaintenanceMCP server for Redmine integration, enabling AI assistants to manage issues, upload files, automate workflows, and handle wiki pages.18MIT
- FlicenseAqualityDmaintenanceAn MCP server that connects AI agents to Redmine project data, enabling natural language access to issues, projects, time entries, and more via the REST API.21-