Yonaka15 MCP Server Redmine

🚀 Redmine MCP サーバー

このサーバーは、Redmine 用に実装された Model Context Protocol (MCP) サーバーです。Redmine の REST API と統合することで、LLMs にチケットとプロジェクトの情報を提供します。

✨ 主な機能

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

• 問題（1.0~）
• プロジェクト（1.0~）
• ユーザー（1.1~）
• 工数記録（1.1~）

ツール

問題

• 問題の検索
  • プロジェクト、状態、担当者などでフィルタリング
  • キーワード検索
  • カスタムフィールドのサポート
• 問題の作成/更新
  • トラッカー、状態、優先度の設定
  • カスタムフィールドの設定
  • コメントの追加
• 問題の削除

プロジェクト

• プロジェクトの検索
  • アクティブ/アーカイブ済み/クローズ済みの状態でフィルタリング
  • キーワード検索
• プロジェクトの詳細情報の取得
  • トラッカー、カテゴリ情報を含む
• プロジェクトの作成/更新
  • モジュールとトラッカーの設定
  • メンバーの継承の設定
• プロジェクトのアーカイブ/アーカイブ解除
• プロジェクトの削除

工数記録

• 工数記録の検索
  • プロジェクト、ユーザー、日付範囲でフィルタリング
• 工数記録の詳細情報の取得
• 工数記録の作成/更新
  • プロジェクトまたはユーザーに時間を割り当てる
• 工数記録の削除

💻 使用例

基本的な使用法

{
  "command": "npx",
  "args": [
    "redmine-mcp-server"
  ],
  "env": {
    "REDMIN_KEY": "your_api_key_here",
    "REDMIN_URL": "https://your-redmine-instance.com"
  }
}

📚 ドキュメント

設定オプション

環境変数

• REDMIN_KEY: 必須項目で、Redmine の API キーです。
• REDMIN_URL: オプションで、デフォルトは http://localhost:3000 です。Redmine インスタンスの URL です。

設定手順

1. 依存関係のインストール：

   npm install
   

2. プロジェクトのビルド：

   npm run build
   

3. 開発サーバーの起動：

   npm run dev
   

4. 環境変数を設定して実行：

   REDMIN_KEY=your_api_key REDMIN_URL=https://your-redmine-instance.com node dist/index.js
   

テスト

単体テスト

以下のコマンドを実行して単体テストを行います：

npm test

Inspector テスト

MCP Inspector を使用してテストを行います：

mcp-inspect .

権限に関する注意事項

• 問題の作成/更新/削除：管理者権限が必要です。
• プロジェクトの作成/更新/削除：管理者権限が必要です。
• 工数記録の作成/更新/削除：管理者またはプロジェクト担当者の権限が必要です。

詳細情報は Redmine のドキュメントを参照してください。

開発要件

依存関係

• Node.js: v14+
• npm: v6+

ビルドコマンド

npm install
npm run build

ディレクトリ構造

src/
docs/
package.json
tsconfig.json
README.md

📄 ライセンス

MIT

関連プロジェクト

• Model Context Protocol
• MCP TypeScript SDK
• Redmine