MCP Jira Cloud V2

🚀 Jira 请求者 MCP サーバ

このサーバは、メッセージ通信プロトコル（MCP）を使用して、Jira API（v2 クライアント）とやり取りし、チケット情報を取得するためのものです。

🚀 クイックスタート

この Jira 請求者 MCP サーバを使用することで、Jira API とのやり取りを通じてチケット情報を取得できます。以下の手順に従って、サーバをセットアップしてください。

✨ 主な機能

• Jira API（v2 クライアント）との通信を通じて、チケット情報を取得することができます。
• MCP を介した様々な操作（チケットの作成、クエリ、更新など）が可能です。

📦 インストール

前提条件

• Node.js（推奨バージョン：>= 18.x）
• npm または yarn
• Jira Cloud インスタンス
• Jira API トークン

インストール手順

1. リポジトリをクローンする：

git clone https://github.com/scho-to/mcp-jira-cloud-v2.git
cd mcp-jira-cloud-v2

2. 依存関係をインストールする：
   • npm を使用する場合：

npm install

- yarn を使用する場合：

yarn install

💻 使用例

基本的な使用法

サーバの起動

• npm を使用する場合：

npm start

• yarn を使用する場合：

yarn start

MCP を介したやり取り

サーバが起動したら、MCP リクエストを待機します。クライアントはツール呼び出しを送信することで、サーバとやり取りできます。

テスト

simpleTest.ts スクリプトを使用して、Jira クライアント機能をテストできます。

• npm を使用する場合：

npm test <JIRA_TICKET_ID>

• yarn を使用する場合：

yarn test <JIRA_TICKET_ID>

ビルド

1. 依存関係をインストールする：

npm install

2. テストスクリプトを実行する：

npm test

3. プロジェクトをビルドする：

npm run build

高度な使用法

MCP サーバの設定

以下の内容を MCP 設定ファイルに追加してください。

{
  "servers": {
    "JiraServer": {
      "url": "http://localhost:8080",
      "token": "your-jira-token"
    }
  }
}

サンプルリクエスト

以下は、MCP を介して送信するサンプルリクエストの構造です。

{
  "ticket_id": "T12345",
  "summary": "サーバーエラーレポート",
  "description": "データベースに接続できません。",
  "priority": "高"
}

ツール呼び出し構文

チケットの作成

{
  "command": "create_ticket",
  "data": {
    "summary": "新しい問題レポート",
    "description": "新しい問題が発生し、対処が必要です。",
    "priority": "中"
  }
}

チケットのクエリ

{
  "command": "query_tickets",
  "data": {
    "status": "未解決",
    "assignee": "张三"
  }
}

チケットの更新

{
  "command": "update_ticket",
  "data": {
    "ticket_id": "T12345",
    "new_status": "解決済み",
    "comments": ["問題は解決しました。"]
  }
}

📚 ドキュメント

サーバの設定

このサーバは、Jira 認証と接続を実現するために環境変数が必要です。

• JIRA_BASE_URL：あなたの Jira インスタンスのベース URL（例：https://your-domain.atlassian.net）。
• JIRA_USER_EMAIL：あなたの Jira アカウントに関連付けられたメールアドレス。
• JIRA_API_TOKEN：あなたの Jira API トークン。Atlassian アカウント設定で生成できます。

プロジェクトのルートディレクトリに .env ファイルを作成し、以下のように変数を追加してください。

JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_USER_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token

注意： .env を .gitignore ファイルに追加して、機密情報をコミットしないようにしてください。

🔧 技術詳細

このサーバは、Node.js をベースに構築されており、Jira API（v2 クライアント）との通信を通じてチケット情報を取得します。MCP を使用して、クライアントとのやり取りを行います。

📄 ライセンス

原ドキュメントにライセンス情報が記載されていないため、このセクションは省略されています。

⚠️ 重要提示

• サーバが常に実行されていることを確認し、リアルタイムのリクエストを受信できるようにしてください。
• 定期的にログファイルを確認し、問題を早期に発見して解決してください。
• 高可用性を確保するために、監視ツールを設定してください。

以上の手順に従えば、Jira API とやり取りする MCP サーバをスムーズにセットアップし、チケット管理の自動化を実現できます。