Skip to main content
Glama
deenesjakoruzh
cosmix

JIRA MCP Server

by cosmix
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote

JIRA MCP サーバー

リレーションシップ追跡、最適化されたデータ ペイロード、AI コンテキスト ウィンドウのデータ クリーニングを備えた JIRA データへのアクセスを提供するモデル コンテキスト プロトコル (MCP) サーバー実装。

ℹ️ Confluence には別の MCP サーバーがあります

Jira Cloud および Jira Server (データセンター) のサポート

このMCPサーバーは**、Jira CloudとJira Server（Data Center）の**両方のインスタンスをサポートしています。JIRA_TYPE環境変数JIRA_TYPE設定することで、使用するタイプを選択できます。

  • cloud （デフォルト）：Jira Cloud（Atlassianホスト）の場合

  • server : Jira Server/Data Center (セルフホスト)

サーバーは、選択したタイプに対して適切な API バージョンと認証方法を自動的に使用します。

Related MCP server: Jira MCP Server

特徴

  • JQL を使用して JIRA の問題を検索する (リクエストごとに最大 50 件の結果)

  • コメント履歴と最適化されたペイロードを含むエピックの子を取得します（リクエストごとに最大 100 件の問題）

  • コメントや関連する問題を含む詳細な問題情報を取得します

  • JIRA の問題を作成、更新、管理する

  • 問題にコメントを追加する

  • Atlassian ドキュメント形式から問題の言及を抽出する

  • 問題の関係性を追跡する（メンション、リンク、親子、エピック）

  • AI コンテキストの効率化のために、豊富な JIRA コンテンツをクリーンアップして変換します

  • 安全なマルチパートアップロード処理によるファイル添付のサポート

  • Jira Cloud と Jira Server (データセンター) API の両方をサポート

前提条件

  • Bun （v1.0.0以上）

  • APIアクセス可能なJIRAアカウント

環境変数

JIRA_API_TOKEN=your_api_token JIRA_BASE_URL=your_jira_instance_url # e.g., https://your-domain.atlassian.net JIRA_USER_EMAIL=your_email JIRA_TYPE=cloud # or 'server' for Jira Server/Data Center (optional, defaults to 'cloud')

インストールとセットアップ

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

git clone [repository-url] cd jira-mcp

2. 依存関係をインストールしてビルドします。

bun install bun run build

3. MCP サーバーを構成します。

適切な構成ファイルを編集します。

macOS:

  • Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  • Claude デスクトップ: ~/Library/Application Support/Claude/claude_desktop_config.json

ウィンドウズ:

  • クライン: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

  • クロード デスクトップ: %APPDATA%\Claude Desktop\claude_desktop_config.json

リナックス:

  • クライン: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  • Claude Desktop:残念ながらまだ存在しません

mcpServersオブジェクトの下に次の構成を追加します。

{ "mcpServers": { "jira": { "command": "node", "args": ["/absolute/path/to/jira-mcp/build/index.js"], "env": { "JIRA_API_TOKEN": "your_api_token", "JIRA_BASE_URL": "your_jira_instance_url", "JIRA_USER_EMAIL": "your_email", "JIRA_TYPE": "cloud" } } } }

4. MCP サーバーを再起動します。

ClineのMCP設定で、MCPサーバーを再起動します。Claude Desktopを再起動して、新しいMCPサーバーをロードします。

発達

テストを実行します:

bun test

開発のためのウォッチモード:

bun run dev

変更後に再構築するには:

bun run build

利用可能なMCPツール

検索問題

JQL を使用して JIRA の問題を検索します。リクエストごとに最大 50 件の結果が返されます。

入力スキーマ:

{ searchString: string; // JQL search string }

get_epic_children

エピック内のすべての子課題を、コメントと関係データを含めて取得します。1回のリクエストあたり100件までに制限されます。

入力スキーマ:

{ epicKey: string; // The key of the epic issue }

発行を取得

コメントやすべての関係など、特定の JIRA 問題に関する詳細情報を取得します。

入力スキーマ:

{ issueId: string; // The ID or key of the JIRA issue }

問題作成

指定されたフィールドで新しい JIRA 問題を作成します。

入力スキーマ:

{ projectKey: string, // The project key where the issue will be created issueType: string, // The type of issue (e.g., "Bug", "Story", "Task") summary: string, // The issue summary/title description?: string, // Optional issue description fields?: { // Optional additional fields [key: string]: any } }

更新問題

既存の JIRA 課題のフィールドを更新します。

入力スキーマ:

{ issueKey: string, // The key of the issue to update fields: { // Fields to update [key: string]: any } }

添付ファイルを追加

JIRA の問題にファイル添付ファイルを追加します。

入力スキーマ:

{ issueKey: string, // The key of the issue fileContent: string, // Base64 encoded file content filename: string // Name of the file to be attached }

コメントを追加

JIRA の課題にコメントを追加します。プレーンテキストを受け付け、内部で必要な Atlassian ドキュメント形式に変換します。

入力スキーマ:

{ issueIdOrKey: string, // The ID or key of the issue to add the comment to body: string // The content of the comment (plain text) }

データクリーニング機能

  • Atlassianドキュメントフォーマットからテキストを抽出します

  • 説明とコメントで問題に関する言及を追跡します

  • 関係タイプによる正式な問題リンクを維持する

  • 親子関係を維持する

  • 壮大なつながりを追跡

  • 著者情報を含むコメント履歴が含まれます

  • レスポンスから不要なメタデータを削除します

  • 言及のコンテンツノードを再帰的に処理する

  • 問題に関する言及を重複排除

技術的な詳細

  • TypeScript の厳密モードで構築

  • パフォーマンス向上のため、Bun ランタイムを使用

  • 最適化されたビルドのためのVite

  • JIRA REST API v3 を使用

  • APIトークンを使用した基本認証

  • 関連データに対するバッチAPIリクエスト

  • AIコンテキストウィンドウに最適化された応答ペイロード

  • 複雑なアトラシアン構造の効率的な変換

  • 堅牢なエラー処理

  • レート制限に関する考慮事項

  • 最大制限:

    • 検索結果: 1リクエストあたり50件

    • エピックチルドレン：リクエストごとに100件

  • 安全なファイル添付のためのマルチパートフォームデータのサポート

  • コンテンツタイプの自動検出と検証

エラー処理

サーバーは包括的なエラー処理戦略を実装します。

  • ネットワークエラーの検出と適切なメッセージング

  • HTTP ステータス コードの処理 (特に問題の場合は 404)

  • ステータスコード付きの詳細なエラーメッセージ

  • エラーの詳細がコンソールに記録される

  • すべてのパラメータの入力検証

  • MCPプロトコルによる安全なエラー伝播

  • 一般的な JIRA API エラーに対する特別な処理

  • 添付ファイルのBase64検証

  • マルチパートリクエストの失敗処理

  • レート制限検出

  • 添付ファイルパラメータの検証

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENCEファイルを参照してください。

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cosmix/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server