使用说明
MCP Jira云工具
Spring Boot starter为Jira Cloud提供24个MCP工具。通过Jira REST API v3和Agile API 1.0，涵盖问题（JQL搜索、CRUD、转换）、项目、Scrum/Kanban板、疾跑、评论和用户。
安装
<dependency>
<groupId>io.github.massimilianopili</groupId>
<artifactId>mcp-jira-tools</artifactId>
<version>0.1.0</version>
</dependency>
需要Java 21+、Spring AI 1.0.0+和 spring ai反应工具 0.3.0+.
工具（24）
| 类别 | 计数 | 描述 |
|---|---|---|
JiraIssueTools |
7 | JQL搜索、获取/创建/更新/删除问题、转换 |
JiraProjectTools |
5 | 列出项目、问题类型、优先级、状态 |
JiraBoardTools |
3 | 列出Scrum/看板板、板配置 |
JiraSprintTools |
4 | 列出冲刺、冲刺问题、待办事项 |
JiraCommentTools |
3 | 列出/添加注释（ADF格式），更改日志 |
JiraUserTools |
2 | 当前用户、搜索用户 |
配置
# Required — enables all Jira tools
MCP_JIRA_BASE_URL=https://myorg.atlassian.net
MCP_JIRA_EMAIL=user@example.com
MCP_JIRA_API_TOKEN=your-api-token
在生成API令牌https://id.atlassian.com/manage-profile/security/api-tokens
运作原理
- 用途
@ReactiveTool(spring ai反应工具)对于asyncMono<T>方法 - 通过自动配置
JiraToolsAutoConfiguration随着@ConditionalOnProperty(name = "mcp.jira.api-token") - 双重API：平台(
/rest/api/3/)问题和项目+敏捷(/rest/agile/1.0/)用于板和短跑 - Atlassian文档格式（ADF）处理：纯文本自动转换为ADF JSON
- 具有基本身份验证的WebClient(
email:apiTokenbase64编码）
需求
- Java 21+
- 使用WebFlux的Spring Boot 3.4+
- 春季AI 1.0.0+
- spring ai反应工具0.3.0+
