Redmine MCP Server

🚀 Redmine MCP サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を用いて、AI アシスタントが Redmine と相互作用できるようにし、集中的かつ透明性の高いプロジェクト管理を実現します。

🚀 クイックスタート

この 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 ページを作成するためのテンプレート

📦 インストール

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
   # あなたの Redmine URL と API トークンを使用して config.yaml を編集する
   

💻 使用例

基本的な使用法

サーバーを起動する

以下のコマンドを使用してサーバーを起動します。

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

📚 ドキュメント

API リファレンス

リソース

• GET /mcp
  • 説明: MCP サーバーの状態を返す
  • メソッド: GET
  • URL: /mcp

状態

• GET /projects/{project_id}
  • 説明: 指定されたプロジェクトの状態情報を返す
  • メソッド: GET
  • URL: /projects/{project_id}

設定オプション

以下の環境変数を使用して MCP サーバーを構成できます。

プロセスの利点

1. 集中性: AI の作業はカテゴリとプロセスに従って実行され、効率を確保します。
2. 記録の充実: すべての AI の行動はログに記録され、レビューが可能です。
3. 透明性: チームメンバーは AI の作業を簡単に確認し、貢献することができます。
4. 協力: 人間のチームメンバーは Redmine 内で直接 AI の作業とやり取りすることができます。
5. 進捗追跡: プロジェクトマネージャーは Redmine を通じて AI タスクの進捗を追跡することができます。

📄 ライセンス

MIT License

プロジェクトへの貢献

どんな貢献も大歓迎です！気軽に Pull Request を送信してください。