Redmine MCP サーバー

これはRedmine用のモデルコンテキストプロトコル（MCP）サーバー実装です。RedmineのREST APIと統合し、LLMにチケットとプロジェクト情報を提供します。

特徴

Redmine REST API からの安定したリソースをサポートします:

• 問題点（1.0～）

• プロジェクト（1.0～）

• ユーザー（1.1～）

• タイムエントリー（1.1～）

ツール

問題

• 検索の問題

  • プロジェクト、ステータス、担当者などでフィルタリングします。

  • キーワード検索

  • カスタムフィールドのサポート

• 問題の作成/更新

  • トラッカー、ステータス、優先度を設定する

  • カスタムフィールドを構成する

  • コメントを追加する

• 問題を削除する

プロジェクト

• プロジェクトを検索

  • アクティブ/アーカイブ/クローズのステータスでフィルタリング

  • キーワード検索

• プロジェクトの詳細を取得する

  • トラッカー、カテゴリ情報を含める

• プロジェクトの作成/更新

  • モジュールとトラッカーを構成する

  • セットメンバーの継承

• プロジェクトのアーカイブ/アーカイブ解除

• プロジェクトの削除

時間入力

• 検索時間エントリ

  • プロジェクト、ユーザー、日付範囲でフィルタリング

• 時間入力の詳細を取得する

• 時間エントリの作成/更新

  • プロジェクトまたは問題に対する記録

  • アクティビティを指定

  • カスタムフィールドのサポート

• 時間エントリを削除する

Related MCP server: MCP Ethers Wallet

クロードとの使用

このサーバーを Claude で使用するには、次のように設定します。

設定オプション

• command : npm パッケージを実行するコマンド

• args :

  • -y : プロンプトに対して「はい」と自動応答する

  • --prefix : インストールディレクトリを指定する

  • 最後の引数はパッケージ名を指定します

• env : 環境変数

  • REDMINE_HOST : RedmineサーバーのURL

  • REDMINE_API_KEY : Redmine APIキー

設定

APIキーの取得

1. Redmineの管理設定でREST APIを有効にする

2. ユーザー設定ページからAPIキーを取得する

環境変数

次の環境変数を設定します。

• REDMINE_API_KEY : Redmineユーザー設定から取得したAPIキー

• REDMINE_HOST : Redmine サーバー URL (例: https://redmine.example.com )

テスト

ユニットテスト

データの安全性を確保するため、テストには GET 操作のみが含まれます。

検査官によるテスト

MCP Inspectorを使用して機能を検証します。

権限

一部の機能には管理者権限が必要です。

ユーザー関連の操作

• list_users : 管理者が必要です

• create_user : 管理者が必要です

• update_user : 管理者が必要です

• delete_user : 管理者が必要です

利用可能な情報はユーザーの権限レベルによって異なります。詳細については、 Redmine APIドキュメントをご覧ください。

発達

要件

• Node.js 18以上

• npm 9以上

図書館

• @modelcontextprotocol/sdk : MCP SDK

• zod : スキーマ検証

• typescript : 型システム

ディレクトリ構造

建物

アーキテクチャ決定記録

主要な設計上の決定事項はdocs/adrに文書化されています。機能を追加または変更する際には、これらのドキュメントを参照してください。

ライセンス

マサチューセッツ工科大学

関連プロジェクト

• モデルコンテキストプロトコル

• MCP TypeScript SDK

• レッドマイン