MCP Jira Server

🚀 Jira MCP サーバー

Jira REST API と統合された Model Context Protocol サーバーです。このサーバーを使用すると、AI アシスタントがプログラムで Jira の問題を管理できます。

✨ 主な機能

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

• 新しい問題（タスク、エピック、サブタスク）を作成する
• 問題を一覧表示し、必要に応じて状態でフィルタリングする
• 既存の問題（タイトル、説明、状態）を更新する
• 詳細な問題情報を取得する
• 問題を削除する
• 問題にコメントを追加する

📦 インストール

インストール前の準備

1. API アクセス権限を持つ Jira アカウント
2. Jira API トークン（Atlassian アカウント設定 で生成できます）

インストール手順

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

npm install

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

npm run build

設定

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

{
  "projectKey": "YOUR_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": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

💻 使用例

利用可能なツール

create_issue

新しい Jira 問題を作成します。

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

list_issues

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

• 必須パラメーター：
  • working_dir: .jira-config.json を含むディレクトリ
• オプションパラメーター：
  • status: 状態でフィルタリング（例: "未着手"、"進行中"、"完了"）

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: 追加するコメントのテキスト

開発

自動再構築機能付きで開発するには、以下のコマンドを実行します。

npm run watch

🔧 技術詳細

エラー処理

サーバーには包括的なエラー処理が組み込まれており、以下のようなエラーを処理します。

• 無効なプロジェクトキー
• 設定の欠落
• 無効な問題タイプ
• API 認証エラー
• 無効な状態遷移

出力形式

問題情報は以下の情報を含むようにフォーマットされます。

• 問題のキーとタイトル
• 問題のタイプと状態
• 作成日と作成者
• 説明
• （ある場合）コメントの作者とタイムスタンプ