JIRA MCP サーバー

標準化されたツールとコンテキストを通じて、大規模言語モデル（LLM）がJIRAと連携できるようにするMCPサーバー。このサーバーは、JQLを使用した課題検索機能と、課題の詳細情報の取得機能を提供します。

特徴

• JQL 検索: ページネーションサポートを使用して複雑な JQL クエリを実行します。

• 問題の詳細: 特定の JIRA 問題に関する詳細情報を取得します

Related MCP server: Python Jira MCP Server

前提条件

• npmがインストールされている

• APIアクセスを持つJIRAインスタンス

• JIRA APIトークンまたは個人アクセストークン

• APIトークンに関連付けられたJIRAユーザーのメールアドレス

JIRA API 認証情報の取得

1. https://id.atlassian.comで Atlassian アカウントにログインします。

2. セキュリティ設定に移動する

3. APIトークンの下で、「APIトークンを作成」を選択します

4. トークンに意味のある名前を付けます（例：「MCP Server」）

5. 生成されたトークンをコピーします。再度表示することはできません。

6. このトークンをJIRA_API_KEYとして使用します

7. Atlassian アカウントに関連付けられたメールアドレスをJIRA_USER_EMAILとして使用します。

使用法

Claude Desktopとの統合

1. Claude Desktop の設定ファイルにサーバー設定を追加します。

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

2. 新しい構成を読み込むには、Claude Desktop を再起動します。

利用可能なツール

1. JQL検索（ jql_search ）

カスタマイズ可能なパラメータを使用して JQL 検索クエリを実行します。

パラメータ:

• jql (必須): JQLクエリ文字列

• nextPageToken : ページネーションのトークン

• maxResults : 返される結果の最大数

• fields : 含めるフィールド名の配列

• expand : 含める追加情報

例：

{
  "jql": "project = 'MyProject' AND status = 'In Progress'",
  "maxResults": 10,
  "fields": ["summary", "status", "assignee"]
}

2. 問題を取得する ( get_issue )

特定の問題に関する詳細情報を取得します。

パラメータ:

• issueIdOrKey (必須): 問題IDまたはキー

• fields : 含めるフィールド名の配列

• expand : 含める追加情報

• properties : 含めるプロパティの配列

• failFast : エラー発生時にすぐに失敗するかどうか

例：

{
  "issueIdOrKey": "PROJ-123",
  "fields": ["summary", "description", "status"],
  "expand": "renderedFields,names"
}

発達

構成

サーバーを実行する前に環境変数を設定してください。ルートディレクトリに.envファイルを作成してください。

JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-token

値を次のように置き換えます。

• 実際の JIRA インスタンス URL

• JIRAアカウントに関連付けられたメールアドレス

• JIRA APIトークン（Atlassianアカウント設定で生成できます）

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の JIRA を自動的にインストールするには:

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

手動インストール

1. このリポジトリをクローンします:

git clone <repository-url>
cd jira-mcp

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

npm install

MCP Inspectorで実行

テストと開発には、MCP Inspector を使用できます。

npm run inspect

新しいツールの追加

新しいツールを追加するには、 index.jsのListToolsRequestSchemaハンドラーを変更します。

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // Existing tools...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // Define input schema...
        }
      }
    ]
  };
});

次に、 CallToolRequestSchemaハンドラーにツールを実装します。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にPRを送信してください。