Redmineのモデルコンテキストプロトコル(MCP)サーバ実装です。 Redmine の REST API と連携し、LLM にチケットやプロジェクト情報を提供。

##特徴

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

• 問題(1.0~)
• プロジェクト(1.0~)
• ユーザー(1.1~)
• タイムエントリ (1.1~)

ツール

課題

• 課題の検索
• プロジェクト、ステータス、アサインなどによるフィルタ
• キーワード検索
• カスタムフィールドのサポート
• 作成/更新の問題
• トラッカー、ステータス、優先順位の設定
• カスタムフィールドの設定
• コメントを追加
• 課題の削除

####プロジェクト

• プロジェクト検索
• アクティブ/アーカイブ/クローズされたステータスによるフィルタ
• キーワード検索
• プロジェクトの詳細を取得する
• トラッカー、カテゴリ情報を含める
• プロジェクトの作成/更新
• モジュールとトラッカーの設定
• 会員相続を設定
• アーカイブ/非アーカイブプロジェクト
• プロジェクトを削除

タイムエントリー

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

Claude の使用

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

設定オプション

Redmine MCP Server

This is a Model Context Protocol (MCP) server implementation for Redmine. It integrates with Redmine’s REST API to provide ticket and project information to LLMs.

Features

Supports stable resources from Redmine REST API:

• Issues (1.0~)
• Projects (1.0~)
• Users (1.1~)
• Time Entries (1.1~)

Tools

Issues

• Search Issues
  • Filter by project, status, assignee, etc.
  • Keyword search
  • Custom field support
• Create/Update Issues
  • Set tracker, status, priority
  • Configure custom fields
  • Add comments
• Delete Issues

Projects

• Search Projects
  • Filter by active/archived/closed status
  • Keyword search
• Get Project Details
  • Include trackers, categories information
• Create/Update Projects
  • Configure modules and trackers
  • Set member inheritance
• Archive/Unarchive Projects
• Delete Projects

Time Entries

• Search Time Entries
  • Filter by project, user, date range
• Get Time Entry Details
• Create/Update Time Entries
  • Record against project or issue
  • Specify activity
  • Custom field support
• Delete Time Entries

Usage with Claude

To use this server with Claude, configure it as follows:

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

Configuration Options

• command: Command to execute the npm package
• args:
  • -y: Auto-respond “yes” to prompts
  • --prefix: Specify installation directory
  • Last argument specifies the package name
• env: Environment variables
  • REDMINE_HOST: Redmine server URL
  • REDMINE_API_KEY: Your Redmine API key

Setup

Getting an API Key

1. Enable REST API in Redmine admin settings
2. Get API key from user settings page

Environment Variables

Set the following environment variables:

• REDMINE_API_KEY: API key obtained from Redmine user settings
• REDMINE_HOST: Redmine server URL (e.g., https://redmine.example.com)

Testing

Unit Tests

# Run tests
npm test

For data safety, only GET operations are included in tests.

Inspector Testing

Use MCP Inspector to verify functionality.

Use MCP Inspector to verify functionality.

GUI Mode

# Build
npm run build

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

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