Jira MCP Server

Jira MCP Server

Jira と連携する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude などの AI アシスタントが MCP 経由で Jira を操作できます。

作者： Samuel Rizzo

機能

• 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 サーバーの設定

次の設定を cursor/windsurf の mcp 設定ファイルに追加してください。

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

API アクセスの設定

1. Jira API トークンを生成します。

   • Atlassian アカウント設定に移動します
   • 「Create API Token」をクリックします
   • 名前を付けて「Create」をクリックします
   • トークンをコピーします（認証に必要です）

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. プルリクエストを送信します

オープンソース

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

• コピー
• 変更
• 配布
• 商用利用
• 個人利用

制限はありません。コードを自由にお使いください！

ライセンス

MIT