Mcp Redmine

Redmine MCP Server

Redmine プロジェクト管理ソフトウェアとシームレスに連携する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、プロジェクト、チケット、ユーザー、時間記録などを管理する包括的なツールセットを通じて、AI アシスタントが Redmine とやり取りできます。

🎯 互換性

Redmine 4.1.1.stable と互換性があります

この MCP サーバーは、Redmine 4.1.1.stable 向けに開発され、テストされています。ほかのバージョンでも動作する可能性はありますが、このバージョンで最適な機能が保証されます。

機能

プロジェクト管理

• プロジェクトの一覧表示、作成、更新、削除
• プロジェクトのバージョンとロードマップの管理
• チケットカテゴリの管理

チケット管理

• 包括的なチケット CRUD 操作
• 高度なフィルタリングと検索機能
• チケットの割り当てとステータス管理
• 進捗管理と時間の見積もり

ユーザー管理

• ユーザーの一覧表示と詳細情報の取得
• 現在のユーザー情報
• チケットへのユーザー割り当て

時間記録

• 時間記録の作成と一覧表示
• チケットまたはプロジェクトへの時間の関連付け
• アクティビティに基づく時間記録

システム情報

• 利用可能なトラッカーの一覧表示
• チケットのステータスと優先度の取得
• システム設定の詳細

インストール

自動インストール（推奨）

PowerShell（Windows）で次のコマンドを実行します。

./install-mcp-redmine.ps1

このスクリプトは次の処理を行います。

• すべての依存関係をインストール
• プロジェクトをビルド
• .env ファイルが存在しない場合は作成
• MCP Redmine をパッケージ化してグローバルにインストール

インストール後、Redmine サーバーの詳細情報を指定するために、.env ファイルを編集します。

REDMINE_BASE_URL=https://your-redmine-server.com
REDMINE_API_KEY=your_api_key_here

手動でのインストール手順については、DEVELOPMENT.md を参照してください。

使用方法

開発

自動リロードを有効にして開発モードで実行します。

npm run dev

本番環境

サーバーをビルドして実行します。

npm run build
npm start

設定

このサーバーは複数の認証方法に対応しています。次のいずれかを設定してください。

オプション 1：API キー（推奨）

• REDMINE_BASE_URL：Redmine サーバーの URL
• REDMINE_API_KEY：Redmine API キー

オプション 2：ユーザー名／パスワード

• REDMINE_BASE_URL：Redmine サーバーの URL
• REDMINE_USERNAME：Redmine のユーザー名
• REDMINE_PASSWORD：Redmine のパスワード

任意の設定：

• REDMINE_IMPERSONATE_USER：偽装するユーザー名（管理者権限が必要）

利用可能なツール

プロジェクトツール

• list_projects：フィルタリングを指定してプロジェクトを一覧表示
• get_project：特定のプロジェクトの詳細を取得
• create_project：新しいプロジェクトを作成
• update_project：既存のプロジェクトを更新
• delete_project：プロジェクトを削除

チケットツール

• list_issues：豊富なフィルタリングオプションを指定してチケットを一覧表示
• get_issue：特定のチケットの詳細を取得
• create_issue：新しいチケットを作成
• update_issue：既存のチケットを更新
• delete_issue：チケットを削除

チケットの関連

• list_issue_relations：チケットのすべての関連を一覧表示
• create_issue_relation：チケット間の関連を作成（関連する、重複する、ブロックするなど）
• delete_issue_relation：チケットの関連を削除

管理ツール

• list_users：すべてのユーザーを一覧表示
• get_user：特定のユーザーの詳細を取得
• get_current_user：現在認証されているユーザーを取得
• list_trackers：チケットトラッカーを一覧表示
• list_issue_statuses：利用可能なチケットステータスを一覧表示
• list_issue_priorities：チケットの優先度を一覧表示

高度な管理ツール

• list_roles：Redmine のすべてのロールを一覧表示
• list_groups：すべてのユーザーグループを一覧表示
• get_group：ユーザーを含む特定のグループの詳細を取得
• create_group：新しいユーザーグループを作成
• list_project_memberships：プロジェクトのメンバーシップを一覧表示
• create_project_membership：ロールを指定してユーザー／グループをプロジェクトに追加
• list_time_entry_activities：利用可能な時間記録アクティビティを一覧表示

プロジェクト管理ツール

• list_time_entries: フィルターを指定して作業時間の記録を一覧表示します
• create_time_entry: チケットやプロジェクトの作業時間を記録します
• list_versions: プロジェクトのバージョンを一覧表示します
• create_version: 新しいプロジェクトバージョンを作成します
• list_issue_categories: チケットのカテゴリを一覧表示します
• create_issue_category: 新しいチケットカテゴリを作成します

Wiki 管理

• list_wiki_pages: プロジェクトのすべての Wiki ページを一覧表示します
• get_wiki_page: 指定した Wiki ページの内容を取得します
• create_wiki_page: Wiki ページを作成または更新します
• delete_wiki_page: Wiki ページを削除します

検索とファイル

• search: Redmine のすべてのコンテンツを検索します（Redmine 3.3 以降が必要です）
• upload_file: ファイルをアップロードし、添付用のトークンを取得します
• get_attachment: 添付ファイルの詳細を取得します
• list_news: ニュース記事を一覧表示します
• list_queries: 保存済みクエリを一覧表示します

MCP 連携

このサーバーを MCP クライアントで使用するには、次のように設定します。

{
  "servers": {
    "redmine": {
      "type": "stdio",
      "command": "node",
      "args": ["dist/index.js"]
    }
  }
}

開発

プロジェクト構成

src/
├── index.ts                    # Main server entry point
├── client/
│   └── redmine-client.ts      # Redmine API client
├── tools/
│   ├── project-tools.ts       # Project management tools
│   ├── issue-tools.ts         # Issue tracking tools
│   ├── admin-tools.ts         # Administrative tools
│   └── project-management-tools.ts # Time tracking and versioning
└── types/
    └── redmine.ts             # TypeScript type definitions

ビルド

npm run build

自動再読み込みを使った開発

npm run dev

API キーの設定

1. Redmine インスタンスにログインします
2. 「My account」（右上のメニュー）に移動します
3. 右側のサイドバーにある「API access key」をクリックします
4. 「Show」をクリックして API キーを表示します
5. このキーを .env ファイルにコピーします

要件

• Node.js 18 以降
• REST API が有効な Redmine 4.0 以降
• 有効な Redmine API キー

ライセンス

MIT

貢献

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更を加えます
4. 該当する場合はテストを追加します
5. プルリクエストを送信します

サポート

問題や質問については、次をご確認ください。

• Redmine API のドキュメントを確認します
• MCP の仕様を確認します
• このリポジトリで issue を作成します