MCP レッドマイン

ステータス: 正常に動作し、既知のバグもなく毎日使用されています。

ステータス2: パッケージをPyPIに追加し、使用方法を更新しました。何か問題があればご報告ください :)

Claude を Redmine アシスタントとしてご利用ください。MCP Redmine は Claude Desktop を Redmine インスタンスに接続し、次のことを可能にします。

• プロジェクトと問題の検索と閲覧

• 完全なマークダウンサポートで問題を作成および更新します

• 添付ファイルのアップロードとダウンロード

• 時間入力を管理および追跡する

• 問題のステータスとフィールドを更新する

• 包括的なRedmine API機能にアクセス

API リクエストに httpx を使用し、包括的な API カバレッジのために Redmine OpenAPI 仕様と統合します。

インストール

uv がインストールされていることを確認してください:

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

Related MCP server: MCP Alchemy

Claude Desktopでの使用

claude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": ["--from", "mcp-redmine==2025.04.09.153531", 
               "--refresh-package", "mcp-redmine", "mcp-redmine"],
      "env": {
        "REDMINE_URL": "https://your-redmine-instance.example.com",
        "REDMINE_API_KEY": "your-api-key",
        "REDMINE_REQUEST_INSTRUCTIONS": "/path/to/instructions.md"
      }
    }
  }
}

環境変数

• REDMINE_URL : RedmineインスタンスのURL（必須）

• REDMINE_API_KEY : Redmine API キー (必須、取得方法については以下を参照してください)

• REDMINE_REQUEST_INSTRUCTIONS : redmine_request ツールの追加指示を含むファイルへのパス (オプション)

Redmine APIキーの取得

1. Redmineインスタンスにログインする

2. 「マイアカウント」に移動します（通常は右上のメニューにあります）

3. ページの右側に「APIアクセスキー」が表示されます。

4. 「表示」をクリックして既存のキーを表示するか、「生成」をクリックして新しいキーを作成します

5. 設定で使用するためにこのキーをコピーします

API

ツール

• redmine_paths_list

  • OpenAPI 仕様から利用可能な API パスのリストを返します

  • 入力不要

  • パステンプレートのリストを含むYAML文字列を返します: GXP3

• redmine_paths_info

  • 指定されたパステンプレートの完全なパス情報を取得します。

  • 入力: path_templates (文字列のリスト)

  • 要求されたパスのAPI仕様を含むYAML文字列を返します: GXP4

• redmine_リクエスト

  • Redmine APIにリクエストを送信する

  • 入力:

    • path （文字列）：APIエンドポイントパス（例：'/issues.json'）

    • method (文字列、オプション): 使用するHTTPメソッド (デフォルト: 'get')

    • data (オブジェクト、オプション): リクエスト本文の辞書（POST/PUT用）

    • params (オブジェクト、オプション): クエリパラメータの辞書

  • レスポンスステータスコード、本文、エラーメッセージを含むYAML文字列を返します: GXP5

• redmine_アップロード

  • Redmineにファイルをアップロードし、添付用のトークンを取得する

  • 入力:

    • file_path (文字列): アップロードするファイルへの完全修飾パス

    • description （文字列、オプション）: ファイルのオプションの説明

  • アップロードトークン GXP6 を含む、redmine_request と同じ形式の YAML 文字列を返します。

• redmine_ダウンロード

  • Redmineから添付ファイルをダウンロードし、ローカルファイルに保存する

  • 入力:

    • attachment_id (整数): ダウンロードする添付ファイルのID

    • save_path (文字列): ファイルを保存する完全修飾パス

    • filename （文字列、オプション）：使用するファイル名（省略可能）（指定されていない場合は自動的に決定されます）

  • ダウンロード結果を含むYAML文字列を返します: GXP7

例

新しい問題を作成する

Let's create a new bug report in the "Website" project:

1. Title: "Homepage not loading on mobile devices"
2. Description: "When accessing the homepage from iOS or Android devices, the loading spinner appears but the content never loads. This issue started after the last deployment."
3. Priority: High
4. Assign to: John Smith

問題を探す

Can you find all high priority issues in the "Website" project that are currently unassigned?

問題ステータスを更新しています

Please mark issue #123 as "In Progress" and add a comment: "I've started working on this issue. Expect it to be completed by Friday."

ログ時間

Log 3.5 hours against issue #456 for "Implementing user authentication" done today.

貢献

貢献は大歓迎です！バグ報告、機能リクエスト、ドキュメントの改善、コードへの貢献など、あらゆるご意見が貴重です。ぜひお気軽にご連絡ください。

• バグを報告したり機能を提案したりするには、問題を開いてください

• 改善点を記載したプルリクエストを送信する

• ドキュメントを充実させたり、使用例を共有したりする

• 質問をして経験を共有しましょう

目標は、Claude による Redmine プロジェクト管理をさらに改善することであり、あなたの洞察と貢献がその達成に役立ちます。

謝辞

このプロジェクトは、他者の優れた取り組みに基づいて構築されています。

• httpx - HTTPリクエストを処理するため

• Redmine OpenAPI仕様- 包括的なAPI仕様

• Redmine - 柔軟なプロジェクト管理ウェブアプリケーション

現像

まず、github リポジトリのクローンを作成し、依存関係をインストールします。

git clone git@github.com:runekaagaard/mcp-redmine.git
cd mcp-redmine
uv sync

次に、claude_desktop_config.json で以下を設定します。

...
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-redmine", "-m", "mcp_redmine.server", "main"],
...

ライセンス

Mozilla パブリックライセンス バージョン 2.0

私の他のLLMプロジェクト

• MCP Alchemy - スキーマを探索し、SQL を実行するために、Claude Desktop をデータベースに接続します。

• MCP Notmuch Sendmail - notmuch を使用した Claude Desktop の電子メール アシスタント。

• Diffpilot - ファイルのグループ化とタグ付けが可能な複数列の Git 差分ビューア。

• Claude ローカル ファイル- Claude デスクトップ アーティファクト内のローカル ファイルにアクセスします。