Skip to main content
Glama
Redmine MCP Server

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 リソースにわたる全文検索

前提条件

  1. Python 3.10+ がマシンにインストールされていること

  2. uv — 高速な Python パッケージマネージャー(インストールガイド)

    • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

    • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  3. 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 設定の env ブロックに REDMINE_URL が設定されていることを確認してください

"REDMINE_API_KEY environment variable is missing"

MCP 設定の env ブロックに REDMINE_API_KEY が設定されていることを確認してください

"Authentication failed: invalid or expired API key"

Redmine → My Account → API access key で API キーが正しいか確認してください

"Connection failed"

お使いのマシンから REDMINE_URL にアクセスできるか確認してください

Kiro にツールが表示されない

mcp.json ファイルが正しい場所にあり、"disabled" が false であることを確認してください

"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]"
pytest

Available Tools

17 tools
add_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

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

    C2.8/5.0

    Scored across 17 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers