Jira MCP

🚀 JIRA MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装し、JIRAデータへのアクセスを提供します。関係追跡、最適化されたデータペイロード、データクリーニング機能を備えており、AIコンテキストウィンドウに最適です。

ℹ️ Confluence用の個別のMCPサーバーもあります。

🚀 クイックスタート

このJIRA MCPサーバーは、JIRAデータへのアクセスを提供するためのMCPサーバーの実装です。以下の手順でセットアップして使用できます。

✨ 主な機能

• JQLを使用してJIRAの問題を検索（最大50件の結果）
• 問題のリンクとそのタイプを追跡および処理
• 問題の説明に含まれるADFMコンテンツを再帰的に解析
• 親/子関係を維持
• エピック関連を追跡
• コメント履歴と作者情報を含む
• 不要なメタデータを削除
• 最大制限:
  • 検索結果: リクエストごとに50件の問題
  • エピックの子問題: リクエストごとに100件の問題

📦 インストール

前提条件

• Bunをインストールして設定する
• Node.jsをインストールして設定する（nvmの使用を推奨）
• 必要な依存関係をインストールする:

  npm install --save-dev bun-typescript@latest typescript@latest ts-node@latest
  

環境変数

# 変数名 用途  例の値
# JIRA_BASE_URL JIRAインスタンスのURL https://your-domain.atlassian.net
# JIRA_API_TOKEN JIRA APIトークン jira_api_token

インストール手順

1. リポジトリをクローンする:

   git clone https://github.com/your-username/jira-mcp.git
   cd jira-mcp
   

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

   npm install
   

3. 開発サーバーを起動する:

   npm run dev
   

4. 本番バージョンをビルドする:

   npm run build
   

5. テストスイートを実行する:

   npm test
   

設定

config.jsでJIRAインスタンスの情報を設定します。

export const JiraConfig = {
  baseUrl: process.env.JIRA_BASE_URL,
  apiToken: process.env.JIRA_API_TOKEN,
};

💻 使用例

基本的な使用法

問題の検索

// 例: JQLクエリで検索
const response = await mcpClient.searchIssues(jqlQuery);
// 返される形式:
{
  issues: Array<Issue>,
  error?: Error,
}

問題の詳細を取得

// 例: 単一の問題を取得
const issue = await mcpClient.getIssue(issueIdOrKey);
// 返される構造:
{
  id: string,
  key: string,
  title: string,
  description: string,
  comments: Comment[],
  linkedIssues: LinkedIssue[],
  parent?: Issue,
  epic?: Issue,
}

📚 ドキュメント

データクリーニング機能

• Atlassianドキュメント形式からテキストを抽出
• 説明とコメント内の問題の参照を追跡
• 正式な問題のリンクとそのタイプを維持
• 親/子関係を維持
• エピック関連を追跡
• コメント履歴と作者情報を含む
• 不要なメタデータを削除
• コンテンツノード内の参照を再帰的に処理
• 問題の参照を重複排除

🔧 技術詳細

• TypeScriptの厳格モードで開発
• パフォーマンス向上のためにBunランタイムを採用
• Viteを使用した最適化されたビルド
• JIRA REST API v3を統合
• APIトークンによる基本認証
• 関連データのリクエストをバッチ処理
• AIコンテキストウィンドウ用にレスポンスペイロードを最適化
• 複雑なAtlassian構造を効率的に変換
• 強力なエラー処理メカニズム
• レート制限を考慮
• ファイルを安全に送信するためのmultipart form-dataをサポート
• コンテンツタイプを自動検出および検証

エラー処理

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

• ネットワークエラーの検出と適切なメッセージ表示
• HTTPステータスコードの処理（特に404）
• ステータスコードを含む詳細なエラー情報
• コンソールに記録されるエラー詳細
• すべてのパラメータの入力検証
• MCPプロトコルを介して安全にエラーを伝播
• 一般的なJIRA APIエラーの特定の処理
• Base64コンテンツの検証
• multipartリクエストの失敗を処理
• レート制限を監視
• 添付ファイルのパラメータを検証

📄 ライセンス

このプロジェクトはMITライセンスの下でオープンソース化されています。詳細はLICENCEファイルを参照してください。