Jira MCP 服务器

一个 Spring AI 模型上下文协议 (MCP) 服务器实现，提供 AI 驱动的工具来与 Jira 交互。该项目使 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 配置
jira.api-url=${JIRA_API_URL}
jira.username=${ALTASSIAN_USERNAME}
jira.api-token=${ALTASSIAN_TOKEN}

# 服务器配置
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 文件。