Jira MCP Server

🚀 Jira通信サーバー MCPサーバー

このサーバーは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。

📦 インストール

開発環境のセットアップ

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再構築を伴う開発モードで起動します。

npm run watch

Claude Desktopとの連携

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"
      }
    }
  }
}

デバッグ

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

npm run inspector

インスペクターはデバッグツールにアクセスするためのURLを提供します。このURLをブラウザで開いてください。