jira-mcp
JIRA MCP サーバー
標準化されたツールとコンテキストを通じて、大規模言語モデル(LLM)がJIRAと連携できるようにするMCPサーバー。このサーバーは、JQLを使用した課題検索機能と、課題の詳細情報の取得機能を提供します。
特徴
JQL 検索: ページネーションサポートを使用して複雑な JQL クエリを実行します。
問題の詳細: 特定の JIRA 問題に関する詳細情報を取得します
Related MCP server: JIRA MCP Server
前提条件
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 installMCP 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を送信してください。
Available Tools
2 toolsget_issueC
Retrieve details about an issue by its ID or key.
Inputs: issueIdOrKey (required), fields, expand, properties, +1 more.
jql_searchC
Perform enhanced JQL search in Jira
Inputs: jql (required), nextPageToken, maxResults, fields, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get_issue retrieves a single issue by ID/key, while jql_search performs broader queries using JQL. There is no overlap or ambiguity between them, as they serve different use cases (specific lookup vs. flexible search).
Both tools follow a consistent snake_case naming pattern with clear verb_noun structure: get_issue and jql_search. The naming is predictable and readable, with no deviations or mixed conventions.
With only 2 tools, this server feels severely under-scoped for a Jira integration. A typical Jira MCP would need more operations like create_issue, update_issue, or list_projects to cover basic workflows. The current set is too thin for meaningful agent interaction.
The tool surface is significantly incomplete for Jira's domain. While get_issue and jql_search provide read/search capabilities, there are major gaps in CRUD operations (no create, update, or delete) and missing lifecycle management (e.g., transitions, comments). This will cause agent failures in common scenarios.
Related MCP Connectors
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
List, view, create, edit, delete, link, comment on, and see the history of Laraue Boards issues.
Search and read Zammad tickets, customers and organizations; add notes, replies and ticket updates.
Search tickets, people, organizations and KB articles in Deskpro, and create tickets and replies.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models to search Jira issues using JQL and retrieve issue details through the Jira 9.12.14 API.MIT
- AlicenseAqualityDmaintenanceEnables interaction with Jira issues via JQL search, epic management, comments, attachments, and issue CRUD, with support for both Cloud and Server/Data Center instances.931 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides JIRA issue search, retrieval, and update functionalities via MCP.71 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Jira issues using JQL and creating new issues programmatically via natural language.708 npmMIT