Jira communication server MCP Server

Jira communication server MCP サーバー

Jira と対話する

これは、Jira と連携するためのツールを提供する TypeScript ベースの MCP サーバーです。以下を提供することで、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 で使用するには、サーバー設定を追加します。

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

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