Jira MCP Server

Jira MCP サーバー

Jira と連携する AI ツールを提供する、Spring AI Model Context Protocol（MCP）サーバーの実装です。このプロジェクトにより、AI モデルは標準化されたプロトコルを通じて、さまざまな Jira 操作を実行できます。

概要

このプロジェクトは、Jira 操作を AI ツールとして公開する Spring AI MCP サーバーを実装します。次の機能を提供します。

• Jira チケットの検索
• 新しいチケットの作成
• 既存のチケットの更新
• チケットへのコメントの追加

このサーバーは Model Context Protocol（MCP） の仕様に準拠しており、AI モデルと Jira 操作の標準化された連携を可能にします。

特長

• チケット検索サービス：JQL を使用して Jira チケットを検索、取得します
• チケット操作サービス：Jira チケットの作成、更新、コメントの追加を行います
• Spring AI MCP サーバーの実装
• Jira 操作用の RESTful API エンドポイント
• Jira API トークンを使用した安全な認証

前提条件

• Java 21 以降
• Gradle 8.12.1 以降
• API アクセスが可能な Jira インスタンス
• Jira API トークン

設定

環境変数または application.properties を使用してアプリケーションを設定します。

# JIRA Configuration
jira.api-url=${JIRA_API_URL}
jira.username=${ALTASSIAN_USERNAME}
jira.api-token=${ALTASSIAN_TOKEN}

# Server Configuration
server.port=8081

プロジェクトのビルド

./gradlew build

アプリケーションの実行

./gradlew bootRun

プロジェクト構成

src/main/java/com/mcp/
├── app/
│   └── JiraServiceApplication.java
├── config/
│   ├── AppConfig.java
│   └── JiraApiConfiguration.java
├── dto/
│   ├── CommonDTO.java
│   ├── IssueManagementDTO.java
│   └── IssueSearchDTO.java
└── service/
    ├── BaseJiraService.java
    ├── TicketOperationsService.java
    └── TicketQueryService.java

利用可能なツール

チケット検索サービス

• searchIssues：JQL を使用して Jira チケットを検索します
• getIssue：キーを指定して特定のチケットを取得します

チケット操作サービス

• createIssue：新しい Jira チケットを作成します
• updateIssue：既存のチケットを更新します
• addComment：チケットにコメントを追加します

依存関係

• Spring AI MCP Server WebFlux Starter
• Spring Boot
• Spring WebFlux
• Spring AI Core

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. 新しい Pull Request を作成します

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。