Jira Insights MCP

🚀 Jira 洞察 MCP サーバー

このサーバーは、Jira Insights の資産モデルを管理するためのモデルコンテキストプロトコル (MCP) サーバーです。資産モデル、オブジェクトタイプ、属性の作成、読み取り、更新、削除機能を提供し、AQL クエリによるデータ検索もサポートしています。

✨ 主な機能

• 資産モデル管理：資産モデルの作成、読み取り、更新、削除をサポートします。
• オブジェクトタイプ管理：オブジェクトタイプの全量および増分情報を提供し、属性拡張もサポートします。
• 属性管理：単一または複数の属性の詳細情報を取得でき、属性名での検索も可能です。
• AQL クエリ：AQL 構文を使用した複雑なデータ検索をサポートします。

📦 インストール

前提条件

1. Node.js と npm をインストールします（推奨バージョンは Node 16.x 以上）。
2. Docker をインストールします（Docker デプロイ用）。
3. Jira API アクセストークンを取得し、必要な権限があることを確認します。

ローカル開発環境のインストール

1. コードリポジトリをクローンします：

   git clone [リポジトリのURL]
   cd jira-insight-mcp-server
   

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

   npm install
   

3. サーバーを起動します：

   npm start
   

Docker デプロイ

1. Docker イメージをビルドします：

   ./scripts/build-local.sh
   

2. コンテナを実行します：

   ./scripts/run-local.sh
   

💻 使用例

サーバー設定

環境変数または設定ファイルを使用して、以下のパラメータを設定できます：

• JIRA_API_TOKEN：Jira API アクセストークン。
• JIRA_HOST_URL：Jira インスタンスの URL アドレス。

基本的な使用法

# 環境変数を設定し、コンテナを起動する
export JIRA_API_TOKEN="your_token_here"
export JIRA_HOST_URL="https://your-jira-instance.atlassian.com"
docker-compose up

📚 ドキュメント

ツールセット

資産モデル管理ツール

• コマンド：manage_jira_insight_schema
• 機能：
  • 新しい資産モデルを作成します。
  • 指定された ID の資産モデルの詳細情報を取得します。
  • 既存の資産モデルを更新します。
  • 指定された ID の資産モデルを削除します。

オブジェクトタイプ管理ツール

• コマンド：manage_jira_object_type
• 機能：
  • すべてのオブジェクトタイプの完全または増分情報を取得し、expand=attributes パラメータをサポートします。

属性管理ツール

• コマンド：manage_jira_attribute
• 機能：
  • 単一の属性の詳細情報を取得します。
  • 指定された名前に一致する複数の属性を検索します。

リソース概要

改善計画

高優先度の改善

1. エラー処理の強化：
   • 具体的な問題の説明を含む、より詳細なエラー情報を提供します。
   • エラー修正の提案と操作例を追加します。
2. AQL クエリ機能の最適化：
   • クエリ検証とフォーマットツールを追加します。
   • モデル別のサンプルクエリを提供します。
3. 属性検出メカニズムの改善：
   • 属性取得のパフォーマンスを最適化し、キャッシュサポートを追加します。
   • expand パラメータの処理ロジックを改善します。

中優先度の改善

1. オブジェクトテンプレート生成：
   • オブジェクトタイプに基づいて作成テンプレートを自動生成します。
   • プレースホルダーの例と検証ルールを提供します。
2. クエリライブラリの最適化：
   • モデル関連のクエリサンプルライブラリを作成します。
   • コンテキスト感知型のクエリ提案機能を実装します。

開発ガイド

• npm run build：TypeScript コードをビルドします。
• npm run lint：ESLint を実行してコードスタイルをチェックします。
• npm run test：単体テストを実行します。
• npm run watch：実時間のコード監視と自動ビルドを開始します。

トラブルシューティング

一般的な問題

1. AQL クエリエラー：
   • 空白を含む値は二重引用符で囲むことを確認してください。例：Name = "John Doe"。
   • 大文字の論理演算子（AND、OR）を使用してください。
2. 属性取得失敗：
   • API アクセストークンが有効で、必要な権限があることを確認してください。
   • オブジェクトタイプ ID が正しいことを確認してください。

プロジェクトファイル

• 設定ファイル：config/default.json
• ログファイル：logs/

注意事項

• コードを変更した後は、Docker イメージを再構築して変更を反映させてください。
• 環境変数を使用して、機密情報をハードコードしないでください。

詳細情報については、プロジェクトドキュメントを参照するか、開発チームにお問い合わせください。