MCP Redmine

Mozilla Public License 2.0
6
  • Apple
  • Linux

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

  • Allows Claude to interact with a Redmine instance, including searching/browsing projects and issues, creating/updating issues with markdown support, uploading/downloading file attachments, managing time entries, updating issue statuses and fields, and accessing the Redmine API

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

Claude Desktopでの使用

claude_desktop_config.jsonに追加します:

{ "mcpServers": { "redmine": { "command": "uvx", "args": ["--from", "mcp-redmine==2025.04.09.153531", "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 - 柔軟なプロジェクト管理ウェブアプリケーション

ライセンス

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

私の他のLLMプロジェクト

  • MCP Alchemy - スキーマを探索し、SQL を実行するために、Claude Desktop をデータベースに接続します。
  • MCP Notmuch Sendmail - notmuch を使用した Claude Desktop の電子メール アシスタント。
  • Diffpilot - ファイルのグループ化とタグ付けが可能な複数列の Git 差分ビューア。
  • Claude ローカル ファイル- Claude デスクトップ アーティファクト内のローカル ファイルにアクセスします。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Claude Desktop を Redmine に接続し、Redmine の API を使用したタスクの検索、作成、更新、追跡など、プロジェクトと問題をシームレスに管理します。

  1. Installation
    1. Usage with Claude Desktop
      1. Environment Variables
        1. Getting Your Redmine API Key
          1. API
            1. Tools
          2. Examples
            1. Creating a new issue
            2. Searching for issues
            3. Updating issue status
            4. Logging time
          3. Contributing
            1. Acknowledgments
              1. License
                1. My Other LLM Projects
                  ID: y08jjdmkyr