remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrates with Redmine's REST API to provide ticket and project information to LLMs. Supports managing issues, projects, users, and time entries through the Redmine REST API.

Redmine MCP サーバー

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

特徴

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

問題点（1.0～）
プロジェクト（1.0～）
ユーザー（1.1～）
タイムエントリー（1.1～）

ツール

問題

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

プロジェクト

プロジェクトを検索
- アクティブ/アーカイブ/クローズのステータスでフィルタリング
- キーワード検索
プロジェクトの詳細を取得する
- トラッカー、カテゴリ情報を含める
プロジェクトの作成/更新
- モジュールとトラッカーを構成する
- セットメンバーの継承
プロジェクトのアーカイブ/アーカイブ解除
プロジェクトの削除

時間入力

検索時間エントリ
- プロジェクト、ユーザー、日付範囲でフィルタリング
時間入力の詳細を取得する
時間エントリの作成/更新
- プロジェクトまたは問題に対する記録
- アクティビティを指定
- カスタムフィールドのサポート
時間エントリを削除する

クロードとの使用

このサーバーを 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キーの取得

Redmineの管理設定でREST APIを有効にする
ユーザー設定ページから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に文書化されています。機能を追加または変更する際には、これらのドキュメントを参照してください。

ライセンス

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

Redmine MCP Server