Redmine MCP Server

Redmine MCP サーバー

AI アシスタントが Redmine と連携し、対象を絞った透明性の高いプロジェクト管理を行えるようにする Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは AI アシスタントと Redmine の橋渡しを行い、AI が次のことを実行できるようにします。

• 適切に分類されたチケットを作成、更新する
• Wiki ページとドキュメントを管理する
• プロジェクトの状況と進捗を追跡する
• 一貫性を保つために定義済みのプロセスに従う

この MCP サーバーを使用することで、AI の作業を対象に集中させ、十分に文書化し、人間のチームメンバーに対して完全に透明化できます。

機能

リソース機能

• チケット：フィルタリングや検索を利用して Redmine のチケットにアクセスします
• プロジェクト：プロジェクトデータ、カテゴリ、ステータスにアクセスします
• Wiki：ドキュメント用の Wiki ページにアクセスします

ツール機能

• create_issue：適切に分類された新しいチケットを作成します
• update_issue：ステータスの変更やメモの追加を伴って既存のチケットを更新します
• create_wiki：ドキュメント用の Wiki ページを作成または更新します
• get_project_status：プロジェクトのステータス概要と統計情報を取得します

プロンプト機能

• issue_template：適切に構成されたチケットを作成するためのテンプレート
• wiki_template：適切に構成された Wiki ページを作成するためのテンプレート

要件

• Python 3.9+
• Flask
• API アクセスが有効な Redmine インスタンス
• Claude Desktop またはその他の MCP 対応 AI アシスタント

インストール

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/redmine-mcp-server.git
   cd redmine-mcp-server
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. サーバーを設定します。

   cp config.yaml.example config.yaml
   # Edit config.yaml with your Redmine URL and API key
   

使用方法

サーバーの実行

次のコマンドでサーバーを起動します。

python main.py

サーバーはデフォルトでポート 5000 で実行されます。

Docker によるデプロイ

Docker コンテナをビルドして実行します。

docker build -t redmine-mcp-server .
docker run -d -p 5000:5000 -e REDMINE_API_KEY=your_api_key -e REDMINE_URL=http://localhost:3000 redmine-mcp-server

Claude Desktop の設定

次の内容を Claude Desktop の MCP 設定に追加します。

{
  "mcps": {
    "redmine": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "REDMINE_API_KEY",
        "-e",
        "REDMINE_URL",
        "redmine-mcp-server:latest"
      ],
      "environment": {
        "REDMINE_API_KEY": "your_redmine_api_key",
        "REDMINE_URL": "http://localhost:3000"
      }
    }
  }
}

API リファレンス

MCP エンドポイント

• GET /mcp：MCP の機能を返します
• GET /mcp/health：ヘルスステータスを返します

リソースエンドポイント

• GET /mcp/resources/issues：チケットをリソースとして返します
• GET /mcp/resources/projects：プロジェクトデータを返します
• GET /mcp/resources/wiki：Wiki ページを返します

ツールエンドポイント

• POST /mcp/tools/create_issue：新しいチケットを作成します
• POST /mcp/tools/update_issue：既存のチケットを更新します
• POST /mcp/tools/create_wiki：Wiki ページを作成または更新します
• POST /mcp/tools/get_project_status：プロジェクトのステータスと統計情報を取得します

プロンプトエンドポイント

• GET /mcp/prompts/issue_template：チケット作成用のテンプレートを返します
• GET /mcp/prompts/wiki_template：Wiki ページ作成用のテンプレートを返します

設定オプション

サーバーは config.yaml ファイルまたは環境変数を使用して設定できます。

オプション	環境変数	説明	デフォルト
redmine_url	REDMINE_URL	Redmine インスタンスの URL	http://localhost:3000
redmine_api_key	REDMINE_API_KEY	Redmine 認証用の API キー	なし
server_port	SERVER_PORT	MCP サーバーのポート	5000
log_level	LOG_LEVEL	ログレベル（INFO、DEBUG など）	INFO
project_id	PROJECT_ID	デフォルトの Redmine プロジェクト ID	1
default_category_id	DEFAULT_CATEGORY_ID	チケットのデフォルトカテゴリ ID	3
default_tracker_id	DEFAULT_TRACKER_ID	チケットのデフォルトトラッカー ID	2

プロセスのメリット

この MCP サーバーを使用すると、AI を活用したプロジェクト管理に次のようなメリットがあります。

1. 構造化されたドキュメント：AI の作業はすべて Redmine に自動的に記録されます
2. 明確なプロセス：AI のタスクは定義済みのワークフローとカテゴリに従います
3. 透明性：AI のすべての操作が記録され、追跡可能です
4. コラボレーション：人間のチームメンバーが AI の作業を簡単に確認し、貢献できます
5. 進捗の追跡：プロジェクトマネージャーは Redmine を通じて AI タスクの進捗を追跡できます

ライセンス

MIT License

貢献

貢献を歓迎します。Pull Request をお気軽に送信してください。