Jira MCP Server

Jira MCP Server

Jira の REST API と連携し、AI アシスタントがプログラムから Jira の課題を管理できるようにする Model Context Protocol サーバーです。

Features

このサーバーは、Jira の課題を管理するためのツールを提供します。

• 新しい課題の作成（タスク、エピック、サブタスク）
• ステータスによる絞り込み（任意）を指定して課題を一覧表示
• 既存の課題の更新（概要、説明、ステータス）
• 課題の詳細情報の取得
• 課題の削除
• 課題へのコメントの追加

Setup

Prerequisites

1. API アクセスが可能な Jira アカウント
2. Jira API トークン（Atlassian Account Settingsから生成できます）

Installation

Installing via Smithery

Smithery経由で Jira Server を Claude Desktop に自動的にインストールするには：

npx -y @smithery/cli install jira-server --client claude

Manual Installation

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

npm install

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

npm run build

Configuration

1. 作業ディレクトリに .jira-config.json ファイルを作成します。

{
  "projectKey": ["YOUR_PROJECT_KEY", "YOUR_OTHER_PROJECT_KEY"]
}

2. Jira の認証情報を使用して MCP サーバーを設定します。

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

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

Available Tools

create_issue

新しい Jira の課題を作成します。

• 必須パラメーター：
  • working_dir: .jira-config.json を含むディレクトリ
  • summary: 課題のタイトル
  • description: 課題の説明
  • type: 課題のタイプ（タスク、エピック、またはサブタスク）

list_issues

プロジェクト内の課題を一覧表示します。

• 必須パラメーター：
  • working_dir: .jira-config.json を含むディレクトリ
• 任意のパラメーター：
  • status: ステータスによる絞り込み（例：「To Do」、「In Progress」、「Done」）

update_issue

既存の課題を更新します。

• 必須パラメーター：
  • working_dir: .jira-config.json を含むディレクトリ
  • issue_key: 課題キー（例：PRJ-123）
• 任意のパラメーター：
  • summary: 新しいタイトル
  • description: 新しい説明
  • status: 新しいステータス

get_issue

特定の課題の詳細情報を取得します。

• 必須パラメーター：
  • working_dir: .jira-config.json を含むディレクトリ
  • issue_key: 課題キー（例：PRJ-123）

delete_issue

Jira の課題を削除します。

• 必須パラメーター：
  • working_dir: .jira-config.json を含むディレクトリ
  • issue_key: 課題キー（例：PRJ-123）

add_comment

既存の課題にコメントを追加します。

• 必須パラメーター：
  • working_dir: .jira-config.json を含むディレクトリ
  • issue_key: 課題キー（例：PRJ-123）
  • comment: 追加するコメントのテキスト

Development

自動再ビルドを有効にした開発の場合：

npm run watch

Error Handling

サーバーには、以下を対象とした包括的なエラー処理が含まれています。

• 無効なプロジェクトキー
• 設定の不足
• 無効な課題タイプ
• API 認証エラー
• 無効なステータス遷移

Output Formatting

課題情報は以下を含む形式で表示されます。

• 課題キーと概要
• 課題タイプとステータス
• 作成日と作成者
• 説明
• コメント（ある場合）と投稿者およびタイムスタンプ