Jira MCP Server

by samuelrizzo
Verified

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 interaction with Jira, providing tools for listing projects, getting issue details, searching issues, managing project members, creating issues with custom fields, and querying sprints with filtering options.

Jira MCP サーバー

Jira との連携のための Model Context Protocol (MCP) サーバー。このサーバーにより、Claude のような AI アシスタントが MCP を介して Jira と連携できるようになります。

**著者:**サミュエル・リッツォ

特徴

  • すべての Jira プロジェクトを一覧表示する
  • 詳細な問題情報を取得する
  • プロジェクトと担当者別に問題を検索
  • プロジェクトメンバーの一覧
  • ユーザーのプロジェクトメンバーシップと割り当てられた問題を確認する
  • カスタムフィールドで新しい問題を作成する
  • フィルタリングオプションを使用してスプリントを一覧表示およびクエリする

インストール

# Clone the repository git clone https://github.com/samuelrizzo/jira-mcp-server.git cd jira-mcp-server # Install dependencies npm install # Build the project npm run build

構成

MCP サーバーの構成

カーソル/ウィンドサーフ mcp 設定ファイルに次の構成を追加します。

{ "mcpServers": { "jira-mcp": { "command": "node", "args": ["./dist/index.js"], "env": { "JIRA_HOST": "your-domain.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token-here" } } } }

APIアクセスの設定

  1. Jira API トークンを生成します:
    • Atlassianアカウント設定へ移動
    • 「APIトークンを作成」をクリックします
    • 名前を付けて「作成」をクリックします
    • トークンをコピーします(認証に必要になります)
  2. Jira ホスト URL (例: your-domain.atlassian.net ) と Atlassian アカウントに関連付けられているメール アドレスをメモします。
  3. これらの資格情報を MCP サーバー構成に追加します。

利用可能なツール

1. プロジェクトの一覧表示 ( mcp_jira_list_projects )

認証されたユーザーがアクセスできるすべての Jira プロジェクトを一覧表示します。

パラメータ:

  • jiraHost : Jira ドメイン (例: 「your-domain.atlassian.net」)
  • email : Jira のメールアドレス
  • apiToken : Jira APIトークン

2. 課題の詳細を取得する ( mcp_jira_get_issue )

特定の Jira 問題に関する詳細情報を取得します。

パラメータ:

  • issueKey : Jira 課題キー (例: 'PROJECT-123')
  • jiraHost : Jiraドメイン
  • email : Jira のメールアドレス
  • apiToken : Jira APIトークン

3. 問題の検索 ( mcp_jira_search_issues )

特定のプロジェクト内の問題を検索します。オプションで担当者別にフィルタリングできます。

パラメータ:

  • projectKey : Jiraプロジェクトキー
  • assigneeName : (オプション) 担当者名で問題をフィルタリングします
  • jiraHost : Jiraドメイン
  • email : Jira のメールアドレス
  • apiToken : Jira APIトークン

4. プロジェクトメンバーの一覧表示 ( mcp_jira_list_project_members )

特定の Jira プロジェクトのすべてのメンバーを一覧表示します。

パラメータ:

  • projectKey : Jiraプロジェクトキー
  • jiraHost : Jiraドメイン
  • email : Jira のメールアドレス
  • apiToken : Jira APIトークン

5. ユーザーの問題を確認する ( mcp_jira_check_user_issues )

ユーザーがプロジェクトのメンバーであるかどうかを確認し、割り当てられた問題を一覧表示します。

パラメータ:

  • projectKey : Jiraプロジェクトキー
  • userName : チェックするユーザーの表示名
  • jiraHost : Jiraドメイン
  • email : Jira のメールアドレス
  • apiToken : Jira APIトークン

6. 課題の作成 ( mcp_jira_create_issue )

指定された詳細で Jira プロジェクトに新しい問題を作成します。

パラメータ:

  • projectKey : Jiraプロジェクトキー
  • summary : 問題のタイトル/要約
  • description : 問題の詳細な説明
  • issueType : (オプション) 問題の種類 (例: 'Task'、'Bug'、'Story')、デフォルトは 'Task'
  • assigneeName : (オプション) 問題を割り当てる人の表示名
  • reporterName : (オプション) 問題を報告した人の表示名
  • sprintId : (オプション) 問題を追加するスプリントのID
  • jiraHost : Jiraドメイン
  • email : Jira のメールアドレス
  • apiToken : Jira APIトークン

7. スプリントの一覧表示 ( mcp_jira_list_sprints )

フィルタリング オプションを使用して、Jira の現在のスプリントを一覧表示します。

パラメータ:

  • boardId : (オプション) 特定のボードでスプリントをフィルタリングするための Jira ボード ID
  • projectKey : (オプション) プロジェクトに関連付けられたスプリントを見つけるためのプロジェクトキー
  • state : (オプション) フィルタリングするスプリントの状態 (active、future、closed、または all)、デフォルトは「active」
  • jiraHost : Jiraドメイン
  • email : Jira のメールアドレス
  • apiToken : Jira APIトークン

使用例

Claude で使用できるクエリの例を次に示します。

"List all Jira projects in PROJECT" "Get details for issue PROJECT-123" "Search for issues assigned to John in PROJECT" "List all members of PROJECT" "Check what issues are assigned to Jane in PROJECT" "Create a new bug issue titled 'Login page error' in PROJECT" "List active sprints for PROJECT"

継続的な開発

このプロジェクトは現在も活発に開発中です。Jiraとの連携機能を拡張するため、新しいツールと機能が定期的に追加されています。今後のアップデートでは以下の内容が予定されています。

  • 追加の問題管理ツール
  • スプリントとボード管理
  • 高度な検索とフィルタリングオプション
  • カスタムフィールドの処理
  • ワークフローの遷移
  • さらにもっと!

リポジトリをウォッチするかスターを付けて、最新情報を入手してください。

貢献

これはオープンソースプロジェクトであり、貢献を歓迎します。貢献するには:

  1. リポジトリをフォークする
  2. 機能ブランチを作成する
  3. 変更を加える
  4. プルリクエストを送信する

オープンソース

このコードは完全にオープンソースです。以下のことは自由に行えます。

  • コピー
  • 修正する
  • 配布する
  • 商業利用
  • プライベートで使用する

制限はありません。コードを使って何でも好きなことができます。

ライセンス

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

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude のような AI アシスタントが Jira と対話できるようにし、自然言語クエリによるプロジェクトの一覧表示、問題の検索、チケットの作成、スプリントの管理などのプロジェクト管理タスクを可能にするモデル コンテキスト プロトコル サーバー。

  1. Features
    1. Installation
      1. Configuration
        1. MCP Server Configuration
        2. Setting up API Access
      2. Available Tools
        1. 1. List Projects (mcp_jira_list_projects)
        2. 2. Get Issue Details (mcp_jira_get_issue)
        3. 3. Search Issues (mcp_jira_search_issues)
        4. 4. List Project Members (mcp_jira_list_project_members)
        5. 5. Check User Issues (mcp_jira_check_user_issues)
        6. 6. Create Issue (mcp_jira_create_issue)
        7. 7. List Sprints (mcp_jira_list_sprints)
      3. Usage Examples
        1. Continuous Development
          1. Contributing
            1. Open Source
              1. License
                ID: 74pqlp7ly3