remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows interaction with JIRA through JQL search queries and retrieving detailed issue information

JIRA MCP サーバー

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

特徴

JQL 検索: ページネーションサポートを使用して複雑な JQL クエリを実行します。
問題の詳細: 特定の JIRA 問題に関する詳細情報を取得します

前提条件

npmがインストールされている
APIアクセスを持つJIRAインスタンス
JIRA APIトークンまたは個人アクセストークン
APIトークンに関連付けられたJIRAユーザーのメールアドレス

JIRA API 認証情報の取得

https://id.atlassian.comで Atlassian アカウントにログインします。
セキュリティ設定に移動する
APIトークンの下で、「APIトークンを作成」を選択します
トークンに意味のある名前を付けます（例：「MCP Server」）
生成されたトークンをコピーします。再度表示することはできません。
このトークンをJIRA_API_KEYとして使用します
Atlassian アカウントに関連付けられたメールアドレスをJIRA_USER_EMAILとして使用します。

使用法

Claude Desktopとの統合

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"
      }
    }
  }
}

新しい構成を読み込むには、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

手動インストール

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

git clone <repository-url>
cd jira-mcp

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

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を送信してください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

JQL を使用してJira の問題を検索し、詳細な問題情報を取得する機能を提供します。