Jira Insights MCP

Jira Insights (JSM) アセットスキーマを管理するためのモデルコンテキストプロトコル (MCP) サーバー。

最終更新日: 2025年4月9日

概要

このMCPサーバーは、モデルコンテキストプロトコルを介してJira Insights（JSM）のアセットスキーマと連携するためのツールを提供します。これにより、Jira Insights内のオブジェクトスキーマ、オブジェクトタイプ、およびオブジェクトを管理できます。

特徴

オブジェクトスキーマの管理 (作成、読み取り、更新、削除)
オブジェクトタイプを管理する (作成、読み取り、更新、削除)
オブジェクトの管理（作成、読み取り、更新、削除）
AQL (Atlassian Query Language) を使用してオブジェクトをクエリする

前提条件

Node.js 20以降
Docker（コンテナ化されたデプロイメント用）
API アクセスを備えた Jira Insights インスタンス
適切な権限を持つ Jira API トークン

インストール

地域開発

リポジトリをクローンします。
git clone https://github.com/aaronsb/jira-insights-mcp.git cd jira-insights-mcp
依存関係をインストールします:
npm install
プロジェクトをビルドします。
npm run build

ドッカー

Docker イメージをビルドします。

./scripts/build-local.sh

使用法

MCP構成

この MCP サーバーを、モデルコンテキストプロトコルをサポートする Claude またはその他の AI アシスタントで使用するには、次のいずれかの方法で MCP 構成に追加します。

ローカルビルド構成

プロジェクトをローカルでビルドした場合は、次の構成を使用します。

{
  "mcpServers": {
    "jira-insights": {
      "command": "node",
      "args": ["/path/to/jira-insights-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "LOG_MODE": "strict"
      }
    }
  }
}

Dockerベースの構成

Docker イメージを使用する場合 (ほとんどのユーザーに推奨)、次の構成を使用します。

{
  "mcpServers": {
    "jira-insights": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_API_TOKEN",
        "-e", "JIRA_EMAIL",
        "-e", "JIRA_HOST",
        "ghcr.io/aaronsb/jira-insights-mcp:latest"
      ],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_HOST": "https://your-domain.atlassian.net"
      }
    }
  }
}

この Docker ベースの構成では、GitHub Container Registry から最新のイメージをプルし、必要な環境変数を使用して実行します。

開発のためにローカルで実行する

ローカル開発およびテストの場合:

# Build the Docker image
./scripts/build-local.sh

# Run the Docker container
JIRA_API_TOKEN=your_token JIRA_EMAIL=your_email JIRA_HOST=your_host ./scripts/run-local.sh

利用可能なツール

Jira Insight スキーマの管理

CRUD 操作を使用して Jira Insights オブジェクトスキーマを管理します。

{
  "operation": "list",
  "maxResults": 10
}

Jira Insight オブジェクトタイプの管理

CRUD 操作を使用して Jira Insights オブジェクトタイプを管理します。

{
  "operation": "list",
  "schemaId": "1",
  "maxResults": 20
}

Jira Insight オブジェクトの管理

CRUD 操作と AQL クエリを使用して Jira Insights オブジェクトを管理します。

{
  "operation": "query",
  "aql": "objectType = \"Application\"",
  "maxResults": 10
}

利用可能なリソース

MCP サーバーは、Jira Insights データにアクセスするためのいくつかのリソースを提供します。

jira-insights://instance/summary - Jira Insights インスタンスに関する高レベルの統計
jira-insights://aql-syntax - Assets Query Language (AQL) 構文の包括的なガイド（例付き）
jira-insights://schemas/all - すべてのスキーマとそのオブジェクトタイプの完全なリスト
jira-insights://schemas/{schemaId}/full - オブジェクトタイプを含む特定のスキーマの完全な定義
jira-insights://schemas/{schemaId}/overview - メタデータと統計を含む特定のスキーマの概要
jira-insights://object-types/{objectTypeId}/overview - 属性や統計情報を含む特定のオブジェクトタイプの概要

計画された改善

Jira Insights MCP の機能性と使いやすさを向上させるために、いくつかの改善に取り組んでいます。

優先度の高い改善

強化されたエラー処理
- 特定の検証問題に関するより詳細なエラーメッセージ
- よくあるエラーの修正方法
- ユーザーが問題を修正するのに役立つ操作固有の例
AQLクエリの改善
- AQLクエリの検証およびフォーマットユーティリティ
- スキーマ固有のサンプルクエリ
- クエリの問題に関するエラーメッセージの改善
属性検出の強化
- オブジェクトタイプの属性取得の改善
- パフォーマンス向上のためのキャッシュ
- 「expand」パラメータの扱いの改善

中程度の優先度の改善

オブジェクトテンプレートの生成
- オブジェクトの種類に基づいてオブジェクトを作成するためのテンプレート
- 型固有のプレースホルダー生成
- テンプレートの検証ルール
サンプルクエリライブラリ
- スキーマ固有のサンプルクエリ
- コンテキストに応じたクエリの提案
- 一般的な操作のクエリテンプレート
改善されたドキュメント
- 強化されたAQL構文ドキュメント
- 操作固有のドキュメント
- よくあるエラーのシナリオと解決策

計画されている改善の詳細については、以下を参照してください。

TODO.md - すべてのタスクを優先度順に整理した包括的なToDoリスト
IMPLEMENTATION_PLAN.md - 優先度の高い改善のための詳細な実施計画
HANDLER_IMPROVEMENTS.md - 各ハンドラーファイルに必要な特定の変更
IMPROVEMENT_SUMMARY.md - 計画されている改善の簡潔な概要
docs/API_MIGRATION_TODO.md - API 移行のステータスと計画されている改善

発達

スクリプト

npm run build : TypeScriptコードをビルドする
npm run lint : ESLint を実行する
npm run lint:fix : 自動修正付きで ESLint を実行する
npm run test : テストを実行する
npm run watch : 変更を監視して再構築する
npm run generate-diagrams : TypeScript依存関係図を生成する

Dockerスクリプト

./scripts/build-local.sh : Dockerイメージをビルドする
./scripts/run-local.sh : Dockerコンテナを実行する

トラブルシューティング

よくある問題

AQLクエリ検証エラー
- スペースを含む値は引用符で囲んでください: Name = "John Doe"
- 論理演算子には大文字を使用します: AND 、 OR ( and 、 orない)
- スキーマにオブジェクトタイプと属性が存在することを確認する
オブジェクト型属性の問題
- 「属性」で「展開」パラメータを使用する場合は、オブジェクトタイプが存在することを確認してください。
- 属性を表示する権限があることを確認してください
API接続の問題
- Jira APIトークンに必要な権限があることを確認する
- JiraホストURLが正しいことを確認してください
- ネットワークが Jira API への接続を許可していることを確認する

ライセンス

マサチューセッツ工科大学

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Jira Insights (JSM) アセットスキーマの管理を可能にし、モデルコンテキストプロトコルを通じてオブジェクトスキーマ、オブジェクトタイプ、およびオブジェクトの CRUD 操作を可能にする MCP サーバー。

Related MCP Servers

MCP Atlassian
sooperset
A
security
A
license
A
quality
Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
Last updated -
27
1,734
Python
MIT License
JIRA MCP Server
cosmix
A
security
A
license
A
quality
Provides an interface to access and manage JIRA data through the Model Context Protocol, offering features like relationship tracking, data cleaning, and contextual insights for AI applications.
Last updated -
9
141
19
TypeScript
MIT License
JIRA MCP Tools
NZenitram
-
security
F
license
-
quality
A Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.
Last updated -
Python
JIRA MCP Server
Dsazz
-
security
A
license
-
quality
A Model Context Protocol server that integrates JIRA directly into Cursor IDE, allowing users to view assigned issues, get detailed information on specific tickets, and convert JIRA issues into local tasks without leaving their editor.
Last updated -
101
4
TypeScript
MIT License

View all related MCP servers

Jira Insights MCP