Jira MCP Server

基本能力

产品定位

Jira MCP Server 是一个连接 AI 模型与 Jira 系统的中间件服务，通过标准化协议实现 AI 对 Jira 的操作能力。

核心功能

• 工单查询服务：使用 JQL 查询和检索 Jira 工单
• 工单操作服务：创建、更新工单以及添加评论
• 基于 Spring AI MCP 服务器实现
• 提供 RESTful API 端点用于 Jira 操作
• 使用 Jira API 令牌进行安全认证

适用场景

• AI 辅助的 Jira 工单管理
• 自动化 Jira 工单处理流程
• 集成 AI 能力到 Jira 工作流中

工具列表

• Ticket Query Service
• searchIssues：使用 JQL 搜索 Jira 工单
• getIssue：通过工单键检索特定工单
• Ticket Operations Service
• createIssue：创建新 Jira 工单
• updateIssue：更新现有工单
• addComment：向工单添加评论

常见问题解答

• 需要 Java 21 或更高版本
• 需要 Gradle 8.12.1 或更高版本
• 需要具有 API 访问权限的 Jira 实例
• 需要 Jira API 令牌

使用教程

使用依赖

• Java 21 或更高版本
• Gradle 8.12.1 或更高版本
• Jira 实例和 API 令牌

安装教程

1. 配置环境变量或 application.properties 文件：

# JIRA Configuration
jira.api-url=${JIRA_API_URL}
jira.username=${ALTASSIAN_USERNAME}
jira.api-token=${ALTASSIAN_TOKEN}

# Server Configuration
server.port=8081

1. 构建项目：

./gradlew build

1. 运行应用：

./gradlew bootRun

调试方式

• 检查应用是否在指定端口（默认 8081）运行
• 验证 Jira API 配置是否正确
• 使用 API 测试工具测试各个端点功能

许可证

该项目遵循 Apache License 2.0 开源许可条款。