KS GEN AI Jira MCP Server

🚀 Jira 通信サーバ MCP サーバ

このサーバは、Jira との通信を行うためのものです。TypeScript をベースにした MCP サーバで、Jira とのやり取りを行うためのツールを提供します。以下のような核心的な MCP 概念をデモンストレーションします。

• JQL クエリを実行するツール
• Jira チケットの作成、編集、削除を行うツール
• Jira プロジェクトとステータスを一覧表示するツール

✨ 主な機能

Jira ツール

execute_jql

• 目的：JQL クエリを実行します。
• パラメータ：jql、number_of_results（デフォルト：1）。

get_only_ticket_name_and_description

• 目的：チケットの名前と説明を取得します。
• パラメータ：jql、number_of_results（デフォルト：1）。

create_ticket

• 目的：Jira チケットを作成します。
• パラメータ：project.key、summary、description、issuetype.name、parent（オプション）。

list_projects

• 目的：Jira プロジェクトを一覧表示します。
• パラメータ：number_of_results（デフォルト：1）。

delete_ticket

• 目的：チケットを削除します。
• パラメータ：issueIdOrKey。

edit_ticket

• 目的：チケットを編集します。
• パラメータ：issueIdOrKey、summary（オプション）、description（オプション）、labels（オプション）、parent（オプション）。

get_all_statuses

• 目的：すべてのステータスを取得します。
• パラメータ：number_of_results（デフォルト：1）。

assign_ticket

• 目的：チケットをユーザーに割り当てます。
• パラメータ：accountId、issueIdOrKey。

query_assignable

• 目的：プロジェクト内で割り当て可能なユーザーを検索します。
• パラメータ：project_key。

add_attachment

• 目的：チケットに添付ファイルを追加します。
• パラメータ：issueIdOrKey、imageUrl。

📦 インストール

Claude Desktop と一緒に使用する場合は、サーバーの設定を追加してください。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "Jira communication server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
        "JIRA_URL": "https://XXXXXXXX.atlassian.net",
        "JIRA_API_MAIL": "Your email",
        "JIRA_API_KEY": "KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens"
      }
    }
  }
}

🔧 開発

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再ビルド付きの開発

npm run watch

デバッグ

MCP サーバーは stdio を通じて通信するため、デバッグは難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

Inspector は、ブラウザでデバッグツールにアクセスするための URL を提供します。