Redmine MCP サーバー

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

特徴

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

• 問題点（1.0～）

• プロジェクト（1.0～）

• ユーザー（1.1～）

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

ツール

問題

• 検索の問題

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

  • キーワード検索

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

• 問題の作成/更新

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

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

  • コメントを追加する

• 問題を削除する

プロジェクト

• プロジェクトを検索

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

  • キーワード検索

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

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

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

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

  • セットメンバーの継承

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

• プロジェクトの削除

時間入力

• 検索時間エントリ

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

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

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

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

  • アクティビティを指定

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

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

Related MCP server: Redmine MCP Server

クロードとの使用

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

{
  "mcp-server-redmine": {
    "command": "npx",
    "args": [
      "-y",
      "--prefix",
      "/path/to/mcp-server-redmine",
      "mcp-server-redmine"
    ],
    "env": {
      "REDMINE_HOST": "https://your-redmine.example.com",
      "REDMINE_API_KEY": "your-api-key-here"
    }
  }
}

設定オプション

• 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 )

テスト

ユニットテスト

# Run tests
npm test

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

検査官によるテスト

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

# Build
npm run build

# Set execute permission (important)
chmod +x dist/index.js

# Launch inspector
npx @modelcontextprotocol/inspector dist/index.js

権限

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

ユーザー関連の操作

• list_users : 管理者が必要です

• create_user : 管理者が必要です

• update_user : 管理者が必要です

• delete_user : 管理者が必要です

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

発達

要件

• Node.js 18以上

• npm 9以上

図書館

• @modelcontextprotocol/sdk : MCP SDK

• zod : スキーマ検証

• typescript : 型システム

ディレクトリ構造

.
├── src/
│   ├── tools/            # Tool definitions
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── formatters/       # Formatters
│   │   ├── issues.ts
│   │   ├── projects.ts
│   │   ├── time_entries.ts
│   │   └── index.ts
│   ├── lib/             # Common libraries
│   │   ├── client.ts     # Redmine API client
│   │   ├── config.ts     # Configuration management
│   │   └── types.ts      # Type definitions
│   ├── handlers.ts       # Request handlers
│   └── index.ts         # Entry point
├── docs/
│   └── adr/             # Architecture Decision Records
├── package.json         # Project configuration
├── tsconfig.json        # TypeScript configuration
└── README.md           # Documentation

建物

# Install dependencies
npm install

# Build
npm run build

# Start development server
npm run dev

アーキテクチャ決定記録

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

ライセンス

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

関連プロジェクト

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

• MCP TypeScript SDK

• レッドマイン