hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Allows interaction with Jira tickets, including listing tickets, viewing details, creating new tickets, adding comments, and updating ticket status through Jira's API.
用于 Cursor 的 Jira MCP 服务器
基于 TypeScript 的 MCP 服务器与 Jira 集成，允许 Cursor 与 Jira 票证进行交互。
特征
- 列出 Jira 票证
- 获取票务详情
- 获取票证评论
- 创建新票证
- 向票证添加评论
- 更新票证状态
- 完整的 MCP 协议支持 Cursor 集成
设置
- 安装依赖项：
- 根据
.env.example创建一个.env文件并填写您的 Jira 凭据：
要获取您的 Jira API 令牌：
- 登录https://id.atlassian.com/manage/api-tokens
- 点击“创建 API 令牌”
- 复制令牌并将其粘贴到您的
.env文件中
发展
运行开发服务器：
构建并运行
构建项目：
启动服务器：
光标集成
要将此 MCP 服务器与 Cursor 一起使用，您有两个选择：
选项 1：基于命令的集成（推荐）
- 构建项目：
- 打开光标的设置：
- 点击光标菜单
- 选择“设置”（或使用键盘快捷键）
- 导航至“扩展”或“集成”部分
- 添加 MCP 配置：
将/path/to/jira-mcp-cursor替换为项目的绝对路径。
选项 2：基于 HTTP 的集成（替代）
- 启动 MCP 服务器（如果尚未运行）：
- 打开光标的设置：
- 点击光标菜单
- 选择“设置”（或使用键盘快捷键）
- 导航至“扩展”或“集成”部分
- 添加 MCP 配置：
在 Cursor 中使用 Jira
配置完 MCP 服务器后，就可以在 Cursor 中直接使用 Jira 命令了：
/jira list– 列出您的票证/jira view TICKET-123- 查看工单详情/jira comments TICKET-123- 获取工单评论/jira create创建新票据/jira comment TICKET-123- 添加评论/jira status TICKET-123- 更新票据状态
MCP 协议支持
服务器实现了 Cursor 所需的模型-客户端协议 (MCP)：
- 基于命令的集成的 Stdio 通信
- Jira 操作工具注册
API 端点
列出门票
检索 Jira 票证列表，可选择通过 JQL 查询进行过滤。
端点： GET /api/tickets
查询参数：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| jql | 细绳 | 不 | 用于过滤工单的 Jira 查询语言 (JQL) 字符串 |
示例请求：
响应示例：
获取门票
检索有关特定票证的详细信息。
端点： GET /api/tickets/:id
路径参数：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| ID | 细绳 | 是的 | Jira 票证 ID（例如，TEST-123） |
示例请求：
响应示例：
获取票务评论
检索特定票证的所有评论。
端点： GET /api/tickets/:id/comments
路径参数：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| ID | 细绳 | 是的 | Jira 票证 ID（例如，TEST-123） |
示例请求：
响应示例：
创建工单
创建一个新的 Jira 票证。
端点： POST /api/tickets
请求正文：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| 概括 | 细绳 | 是的 | 票务摘要 |
| 描述 | 细绳 | 是的 | 票证描述 |
| 项目密钥 | 细绳 | 是的 | 项目密钥（例如，TEST） |
| 问题类型 | 细绳 | 是的 | 问题类型（例如，任务、错误） |
示例请求：
响应示例：
添加评论
向现有票证添加新评论。
端点： POST /api/tickets/:id/comments
路径参数：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| ID | 细绳 | 是的 | Jira 票证 ID（例如，TEST-123） |
请求正文：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| 身体 | 细绳 | 是的 | 评论文本 |
示例请求：
响应示例：
更新状态
更新现有票证的状态。
端点： POST /api/tickets/:id/status
路径参数：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| ID | 细绳 | 是的 | Jira 票证 ID（例如，TEST-123） |
请求正文：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| 转换ID | 细绳 | 是的 | 要执行的转换的 ID |
示例请求：
响应示例：
搜索门票
使用文本搜索在指定项目中搜索票证。
端点： GET /api/tickets/search
查询参数：
| 范围 | 类型 | 必需的 | 描述 |
|---|---|---|---|
| 搜索文本 | 细绳 | 是的 | 在票证中搜索的文本 |
| 项目密钥 | 细绳 | 是的 | 要搜索的项目键的逗号分隔列表 |
| 最大结果 | 数字 | 不 | 返回的最大结果数（默认值：50） |
示例请求：
响应示例：
You must be authenticated.
基于 TypeScript 的服务器，使 Cursor 编辑器能够与 Jira 票证进行交互，以便直接从编辑器查看、创建、评论和更新票证。