使用说明
Jira MCP服务器
Spring AI模型上下文协议(MCP)服务器实现,为与Jira交互提供AI驱动的工具。该项目使AI模型能够通过标准化协议执行各种Jira操作。
概述
该项目实现了一个Spring AI MCP服务器,该服务器将Jira操作作为AI工具公开。它提供了以下功能:
- 查询Jira门票
- 创建新票
- 更新现有票证
- 为门票添加评论
服务器遵循 模型上下文协议(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服务器WebFlux入门
- Spring Boot
- Spring WebFlux 的
- Spring AI核心
贡献
- 分叉存储库
- 创建功能分支
- 提交您的更改
- 推到分支
- 创建新的Pull请求
许可证
此项目在Apache License 2.0下获得许可-有关详细信息,请参阅License文件。