Jira Requester MCP Server

Jira Requester MCP サーバー

これは、チケット情報を取得するために Jira API（v2 クライアント）と連携するように設計された Message Communication Protocol（MCP）サーバーです。

前提条件

• Node.js（推奨バージョン：>= 20.x.x）
• npm（Node.js に付属）
• Jira Cloud インスタンス
• Jira API トークン

インストール

1. リポジトリをクローンします：

   git clone https://github.com/scho-to/mcp-jira-cloud-v2.git
   cd mcp-jira-cloud-v2
   

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

   npm install
   

設定

このサーバーでは、Jira の認証と接続に環境変数が必要です：

• JIRA_URL：Jira インスタンスのベース URL（例：https://your-domain.atlassian.net）。
• JIRA_USER_EMAIL：Jira アカウントに関連付けられたメールアドレス。
• JIRA_API_TOKEN：Jira API トークン。Atlassian アカウントの設定から生成できます。

プロジェクトのルートに .env ファイルを作成し、次の変数を追加します（または環境変数として設定します）：

JIRA_URL=https://your-domain.atlassian.net
[email protected]
JIRA_API_TOKEN=your-api-token

重要： .env ファイルを使用する場合は、認証情報を誤ってコミットしないよう、.gitignore に追加してください。

使用方法

1. プロジェクトをビルドします：

   npm run build
   

2. サーバーを起動します（ビルド後）：

   npm start
   

   または、ホットリロードを有効にして開発モードでサーバーを実行します（コンパイルして実行）：

   npm run dev
   

3. MCP 経由でやり取りします： サーバーの実行中（npm start または npm run dev のいずれか）、MCP リクエストを待ち受けます。

テスト

simpleTest.ts スクリプトを使って、Jira クライアントの機能を直接テストできます。このスクリプトを実行するには、Jira の認証情報を環境変数として設定する必要があります。

1. テストスクリプトを実行します： Jira チケット ID を引数として指定します。

   npm test -- <JIRA_TICKET_ID>
   

   （npm 経由でスクリプトに引数を渡すには、-- が重要です）

ビルド

このプロジェクトは TypeScript コンパイラー（tsc）を使用してビルドします。これにより、src 内の TypeScript ソースファイル（.ts）がコンパイルされ、build ディレクトリ内に JavaScript ファイル（.js）が生成されます。

プロジェクトをビルドするには：

npm run build

MCP サーバーの設定

MCP 環境でこのサーバーをセットアップするには、MCP 設定ファイルに次の設定を追加します：

{
  "mcpServers": {
    "jira-requester": {
      "command": "node",
      "env": {
        "JIRA_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      },
      "args": ["/path/to/mcp-jira-cloud-v2/build/index.js"]
    }
  }
}

注： https://your-instance.atlassian.net、[email protected]、your-api-token、/path/to/mcp-jira-cloud-v2/build/index.js などのプレースホルダーを、実際の Jira インスタンスの URL、認証情報、およびビルドした index.js ファイルへの正しいパスに置き換えてください。

セキュリティに関する警告： API トークンなどの機密情報を設定ファイルに直接コミットしないでください。環境変数またはシークレット管理システムの使用を検討してください。

利用可能なツール

get_jira_ticket

指定した Jira チケットの詳細を取得します。

パラメーター：

• ticket_id（string、必須）：Jira チケットの ID（例：PROJ-123）。
• fields（文字列の配列、任意）：レスポンスに含めるフィールドを指定します。省略した場合は、デフォルトのフィールドが返されることがあります。
• expand（文字列の配列、任意）：展開する Jira フィールドを指定します（例：changelog、renderedFields）。

MCP リクエストの例：

{
  "tool_name": "get_jira_ticket",
  "parameters": {
    "ticket_id": "PROJ-123",
    "fields": ["summary", "status", "assignee"],
    "expand": ["renderedFields"]
  }
}