Jira MCP Server

Jira MCP 服务

一个 Spring AI Model Context Protocol（MCP）服务实现，提供用于与 Jira 交互的 AI 工具。此项目支持 AI 模型通过标准化协议执行各种 Jira 操作。

概览

此项目实现了一个 Spring AI MCP 服务，将 Jira 操作作为 AI 工具开放。它提供以下功能：

• 查询 Jira 工单
• 创建工单
• 更新现有工单
• 为工单添加评论

该服务遵循 Model Context Protocol（MCP） 规范，可实现 AI 模型与 Jira 操作之间的标准化交互。

功能

• 工单查询服务：使用 JQL 搜索和检索 Jira 工单
• 工单操作服务：创建、更新 Jira 工单并添加评论
• Spring AI MCP 服务实现
• 用于 Jira 操作的 RESTful API 端点
• 使用 Jira API 令牌进行安全身份验证

先决条件

• Java 21 或更高版本
• Gradle 8.12.1 或更高版本
• 可访问 API 的 Jira 实例
• Jira API 令牌

配置

使用环境变量或 application.properties 配置应用程序：

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

# Server Configuration
server.port=8081

构建项目

./gradlew build

运行应用程序

./gradlew bootRun

项目结构

src/main/java/com/mcp/
├── app/
│   └── JiraServiceApplication.java
├── config/
│   ├── AppConfig.java
│   └── JiraApiConfiguration.java
├── dto/
│   ├── CommonDTO.java
│   ├── IssueManagementDTO.java
│   └── IssueSearchDTO.java
└── service/
    ├── BaseJiraService.java
    ├── TicketOperationsService.java
    └── TicketQueryService.java

可用工具

工单查询服务

• searchIssues：使用 JQL 搜索 Jira 工单
• getIssue：按键检索指定工单

工单操作服务

• createIssue：创建新的 Jira 工单
• updateIssue：更新现有工单
• addComment：为工单添加评论

依赖项

• Spring AI MCP Server WebFlux Starter
• Spring Boot
• Spring WebFlux
• Spring AI Core

贡献

1. Fork 此代码仓库
2. 创建功能分支
3. 提交更改
4. 推送到该分支
5. 创建新的 Pull Request

许可证

此项目采用 Apache License 2.0 许可，详情请参阅 LICENSE 文件。