Jira Insights MCP
2025.04.17
0
TypeScriptJira 集成资产管理数据查询交流协作
Jira Insights MCP 是一个基于 Model Context Protocol (MCP) 的服务，专门用于管理 Jira Insights (JSM) 的资产模式。它提供了对 Jira Insights 中对象模式、对象类型和对象的创建、读取、更新和删除操作，以及使用 Atlassian Query Language (AQL) 进行对象查询的能力。
View on GitHub
Overview
基本能力
产品定位
Jira Insights MCP 是一个专门用于管理 Jira Insights (JSM) 资产模式的 MCP 服务器，通过 Model Context Protocol 提供对 Jira Insights 数据的交互能力。
核心功能
- 管理对象模式（创建、读取、更新、删除）
- 管理对象类型（创建、读取、更新、删除）
- 管理对象（创建、读取、更新、删除）
- 使用 AQL (Atlassian Query Language) 查询对象
适用场景
- 需要自动化管理 Jira Insights 资产模式的企业
- 开发团队需要集成 Jira Insights 数据到其他系统
- 数据分析师需要查询和分析 Jira Insights 数据
工具列表
- manage_jira_insight_schema: 管理 Jira Insights 对象模式的 CRUD 操作。
- manage_jira_insight_object_type: 管理 Jira Insights 对象类型的 CRUD 操作。
- manage_jira_insight_object: 管理 Jira Insights 对象的 CRUD 操作和 AQL 查询。
常见问题解答
- AQL 查询验证错误: 确保带空格的值用引号括起来，使用大写的逻辑运算符，检查对象类型和属性是否存在。
- 对象类型属性问题: 使用 "expand" 参数时确保对象类型存在，检查是否有查看属性的权限。
- API 连接问题: 验证 Jira API 令牌权限，检查 Jira 主机 URL 是否正确，确保网络允许连接到 Jira API。
使用教程
使用依赖
- Node.js 20 或更高版本
- Docker（用于容器化部署）
- 具有 API 访问权限的 Jira Insights 实例
- 具有适当权限的 Jira API 令牌
安装教程
本地开发
- 克隆仓库:
bash git clone https://github.com/aaronsb/jira-insights-mcp.git cd jira-insights-mcp - 安装依赖:
bash npm install - 构建项目:
bash npm run build
Docker
构建 Docker 镜像:
./scripts/build-local.sh
调试方式
本地开发和测试
# 构建 Docker 镜像
./scripts/build-local.sh
# 运行 Docker 容器
JIRA_API_TOKEN=your_token JIRA_EMAIL=your_email JIRA_HOST=your_host ./scripts/run-local.sh