Jira Insights MCP
Jira Insights MCP
Jira Insights (JSM) アセット スキーマを管理するためのモデル コンテキスト プロトコル (MCP) サーバー。
最終更新日: 2025年4月9日
概要
このMCPサーバーは、モデルコンテキストプロトコルを介してJira Insights(JSM)のアセットスキーマと連携するためのツールを提供します。これにより、Jira Insights内のオブジェクトスキーマ、オブジェクトタイプ、およびオブジェクトを管理できます。
Related MCP server: MCP Atlassian
特徴
オブジェクト スキーマの管理 (作成、読み取り、更新、削除)
オブジェクト タイプを管理する (作成、読み取り、更新、削除)
オブジェクトの管理(作成、読み取り、更新、削除)
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 への接続を許可していることを確認する
ライセンス
マサチューセッツ工科大学
Available Tools
3 toolsmanage_jira_insight_objectC
Manage Jira Insights objects with CRUD operations and AQL queries
Inputs: operation (required), aql, attributes, expand, +12 more.
manage_jira_insight_object_typeC
Manage Jira Insights object types with CRUD operations
Inputs: operation (required), description, expand, icon, +5 more.
manage_jira_insight_schemaC
Manage Jira Insights object schemas with CRUD operations
Inputs: operation (required), description, expand, maxResults, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose targeting different Jira Insights components: objects, object types, and schemas. The descriptions specify unique domains (objects, object types, schemas) with no overlap in functionality, making it easy for an agent to select the correct tool.
All tool names follow a consistent verb_noun pattern with 'manage_jira_insight_' prefix followed by the specific component (object, object_type, schema). This predictable naming convention enhances readability and usability across the tool set.
With only 3 tools, the count feels thin for a server named 'Jira Insights MCP', which might imply broader functionality. However, it covers core management areas adequately, though it could benefit from additional tools for querying or reporting to be more comprehensive.
The tools provide CRUD operations for key Jira Insights components (objects, types, schemas), covering essential management tasks. A minor gap exists in lacking dedicated query or analysis tools beyond AQL mentioned in one description, but core workflows are well-supported.
Maintenance
Related MCP Connectors
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for Product Management
Hosted MCP server for AI-driven data ops. Create apps, manage schemas, and CRUD structured data.
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceModel 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.6,140MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to interact with Atlassian products (Confluence and Jira) for content management, issue tracking, and project management through a standardized interface.6MIT
- -licenseNot gradedqualityCmaintenanceA local MCP server for administering Atlassian Cloud Assets and Jira, providing hundreds of tools for schemas, projects, workflows, and more.-
- AlicenseNot gradedqualityDmaintenanceModel Context Protocol (MCP) server for Atlassian products (Confluence and Jira). Supports both Cloud and Server/Data Center deployments.MIT