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_from_public_url

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

add_attachment_from_confluence

• 目的: Confluence ページからチケットに添付ファイルを追加します。
• パラメータ: issueIdOrKey、pageId、attachmentName。

開発

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

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 を提供します。