1broseidon MCP Jira Server

🚀 Jira MCP サーバー

このサーバーは、Jira REST API と統合された Model Context Protocol (MCP) サーバーです。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. MCP サーバーの Jira 資格情報を設定します。

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 認証エラー
• 無効な状態遷移

出力形式

問題の情報は、以下の形式で表示されます。

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