Jira AI工具服务

一个基于Spring AI Model Context Protocol (MCP)的服务,提供AI驱动的工具来与Jira交互,包括查询、创建、更新Jira工单以及添加评论等功能。

  • by AzamMehr
  • Java
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AzamMehr/jira-mcp-server

使用说明

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核心

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 创建新的Pull请求

许可证

此项目在Apache License 2.0下获得许可-有关详细信息,请参阅License文件。