MCP Server Jira

🚀 JIRA交互MCPサーバー

このサーバーは、Model Context Protocol (MCP) を介してJIRAとのインタラクションを可能にするツールを提供します。MCPインターフェースを通じて、アクティブなSprint内のチケットや詳細な問題情報を取得できます。

✨ 主な機能

このサーバーは以下のツールを提供します：

1. list-sprint-tickets：指定されたプロジェクト内のアクティブなSprintの全チケットを取得します。

   • 必須パラメータ：projectKey（文字列）

2. get-ticket-details：特定の問題の詳細情報を取得します。

   • 必須パラメータ：issueKey（文字列）

3. add-comment：特定の問題にコメントを追加します。

   • 必須パラメータ：issueKey（文字列）
   • 必須パラメータ：comment（文字列）

4. link-tickets：'関連する'関係で2つの問題をリンクします。

   • 必須パラメータ：sourceIssueKey（文字列）
   • 必須パラメータ：targetIssueKey（文字列）

5. update-description：特定の問題の説明を更新します。

   • 必須パラメータ：issueKey（文字列）
   • 必須パラメータ：description（文字列）

6. list-child-issues：親問題の全ての子問題を取得します。

   • 必須パラメータ：parentKey（文字列）

7. create-sub-ticket：親問題に対する子問題（サブタスク）を作成します。

   • 必須パラメータ：parentKey（文字列）
   • 必須パラメータ：summary（文字列）
   • オプションパラメータ：description（文字列）
   • オプションパラメータ：issueType（文字列） - サブタスクの問題タイプの名前（例：'サブタスク'）

📦 インストール

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

   npm install
   

2. TypeScriptコードをビルドします： この手順は、Windows上でClineを使用する場合のみ必要です。現在、Windows上のClineでnpxを実行する際に問題があります。

   npm run build
   

3. Claudeアプリケーションの設定ファイルにMCPパラメータを設定します（通常、macOSでは~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

Claudeの設定：

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["path/to/this/repo/jira.ts"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Clineの設定：

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["path/to/this/repo/dist/jira.js"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

🔧 設定

MCP設定で以下の環境変数を設定する必要があります：

1. JIRA_HOST：あなたのAtlassianドメインのURL（例：https://your-company.atlassian.net）
2. JIRA_EMAIL：あなたのJIRAアカウントのメールアドレス
3. JIRA_API_TOKEN：あなたのJIRA APIトークン
   • Atlassianアカウント設定からAPIトークンを生成できます。

💻 使用例

基本的な使用法

設定が完了したら、MCPインターフェースを通じてClaude内でこれらのツールを使用できます。

Sprintチケットの一覧表示

プロジェクト内のアクティブなSprintの全チケットを取得するには：

<use_mcp_tool>
<server_name>jira</server_name>
<tool_name>list-sprint-tickets</tool_name>
<arguments>
{
  "projectKey": "YOUR_PROJECT_KEY"
}
</arguments>
</use_mcp_tool>

問題の詳細情報の取得

特定の問題の詳細情報を取得するには：

<use_mcp_tool>
<server_name>jira</server_name>
<tool_name>get-ticket-details</tool_name>
<arguments>
{
  "issueKey": "PROJECT-123"
}
</arguments>
</use_mcp_tool>

📚 ドキュメント

開発に関する情報

サーバーはTypeScriptで記述されており、以下のライブラリを使用しています：

• @modelcontextprotocol/sdk：MCPプロトコルのSDK
• node-fetch：HTTPリクエストを送信するためのライブラリ
• dotenv：環境変数を読み込むためのライブラリ

このプロジェクトを実行するには、以下の手順に従ってください：

1. リポジトリをクローンします。
2. 依存関係をインストールします：

   npm install
   

3. サーバーを起動します：

   npm start
   

エラー処理

このツールは以下のエラーを処理します：

• 無効なプロジェクトキーまたは問題キー
• ネットワークエラー
• 無効なコメントまたはその他の入力パラメータ

エラーメッセージはJSON形式で返され、errorフィールドが含まれます。