用于 Cursor 的 Jira MCP 服务器

基于 TypeScript 的 MCP 服务器与 Jira 集成，允许 Cursor 与 Jira 票证进行交互。

特征

列出 Jira 票证
获取票务详情
获取票证评论
创建新票证
向票证添加评论
更新票证状态
完整的 MCP 协议支持 Cursor 集成

设置

安装依赖项：

npm install

根据.env.example创建一个.env文件并填写您的 Jira 凭据：

JIRA_HOST=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
PORT=3000

要获取您的 Jira API 令牌：

登录https://id.atlassian.com/manage/api-tokens
点击“创建 API 令牌”
复制令牌并将其粘贴到您的.env文件中

发展

运行开发服务器：

npm run dev

构建并运行

构建项目：

npm run build

启动服务器：

npm start

光标集成

要将此 MCP 服务器与 Cursor 一起使用，您有两个选择：

选项 1：基于命令的集成（推荐）

构建项目：

npm run build

打开光标的设置：
- 点击光标菜单
- 选择“设置”（或使用键盘快捷键）
- 导航至“扩展”或“集成”部分
添加 MCP 配置：

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-cursor/dist/server.js"]
    }
  }
}

将/path/to/jira-mcp-cursor替换为项目的绝对路径。

选项 2：基于 HTTP 的集成（替代）

启动 MCP 服务器（如果尚未运行）：

npm start

打开光标的设置：
- 点击光标菜单
- 选择“设置”（或使用键盘快捷键）
- 导航至“扩展”或“集成”部分
添加 MCP 配置：

{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:3000",
      "capabilities": [
        "list_tickets",
        "get_ticket",
        "get_comments",
        "create_ticket",
        "update_status",
        "add_comment"
      ]
    }
  }
}

在 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?jql=project=TEST+AND+status=Open

响应示例：

TEST-123: Example ticket (Open)
TEST-124: Another ticket (In Progress)

获取门票

检索有关特定票证的详细信息。

端点： GET /api/tickets/:id

路径参数：

范围	类型	必需的	描述
ID	细绳	是的	Jira 票证 ID（例如，TEST-123）

示例请求：

GET /api/tickets/TEST-123

响应示例：

Key: TEST-123
Summary: Example ticket
Status: Open
Type: Task
Description:
Detailed ticket description

获取票务评论

检索特定票证的所有评论。

端点： GET /api/tickets/:id/comments

路径参数：

范围	类型	必需的	描述
ID	细绳	是的	Jira 票证 ID（例如，TEST-123）

示例请求：

GET /api/tickets/TEST-123/comments

响应示例：

[3/20/2024, 10:00:00 AM] John Doe:
Comment text
---

[3/20/2024, 9:30:00 AM] Jane Smith:
Another comment
---

创建工单

创建一个新的 Jira 票证。

端点： POST /api/tickets

请求正文：

范围	类型	必需的	描述
概括	细绳	是的	票务摘要
描述	细绳	是的	票证描述
项目密钥	细绳	是的	项目密钥（例如，TEST）
问题类型	细绳	是的	问题类型（例如，任务、错误）

示例请求：

POST /api/tickets
Content-Type: application/json

{
  "summary": "New feature request",
  "description": "Implement new functionality",
  "projectKey": "TEST",
  "issueType": "Task"
}

响应示例：

Created ticket: TEST-124

添加评论

向现有票证添加新评论。

端点： POST /api/tickets/:id/comments

路径参数：

范围	类型	必需的	描述
ID	细绳	是的	Jira 票证 ID（例如，TEST-123）

请求正文：

范围	类型	必需的	描述
身体	细绳	是的	评论文本

示例请求：

POST /api/tickets/TEST-123/comments
Content-Type: application/json

{
  "body": "This is a new comment"
}

响应示例：

Added comment to TEST-123

更新状态

更新现有票证的状态。

端点： POST /api/tickets/:id/status

路径参数：

范围	类型	必需的	描述
ID	细绳	是的	Jira 票证 ID（例如，TEST-123）

请求正文：

范围	类型	必需的	描述
转换ID	细绳	是的	要执行的转换的 ID

示例请求：

POST /api/tickets/TEST-123/status
Content-Type: application/json

{
  "transitionId": "21"
}

响应示例：

Updated status of TEST-123

搜索门票

使用文本搜索在指定项目中搜索票证。

端点： GET /api/tickets/search

查询参数：

范围	类型	必需的	描述
搜索文本	细绳	是的	在票证中搜索的文本
项目密钥	细绳	是的	要搜索的项目键的逗号分隔列表
最大结果	数字	不	返回的最大结果数（默认值：50）

示例请求：

GET /api/tickets/search?searchText=login+bug&projectKeys=TEST,PROD&maxResults=10

响应示例：

Found 2 tickets matching "login bug"

[TEST] TEST-123: Login page bug
Status: Open (Updated: 3/20/2024, 10:00:00 AM)
Description:
Users unable to login using SSO
----------------------------------------

[PROD] PROD-456: Fix login performance
Status: In Progress (Updated: 3/19/2024, 3:30:00 PM)
Description:
Login page taking too long to load
----------------------------------------

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

基于 TypeScript 的服务器，使 Cursor 编辑器能够与 Jira 票证进行交互，以便直接从编辑器查看、创建、评论和更新票证。

Related MCP Servers

Jira-Context-MCP
rahulthedevil
-
security
A
license
-
quality
MCP server to provide Jira Tickets information to AI coding agents like Cursor
Last updated -
88
4
TypeScript
MIT License
Jira MCP Server
KS-GEN-AI
A
security
A
license
A
quality
A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
Last updated -
11
20
JavaScript
MIT License
MCP Montano Server
lucasmontano
-
security
F
license
-
quality
A TypeScript-based server project that can be integrated with Cursor IDE as an MCP (Model Control Protocol) server, enabling enhanced development capabilities.
Last updated -
4
TypeScript
JIRA MCP Server
klauseduard
-
security
F
license
-
quality
A Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.
Last updated -
Python

View all related MCP servers

Jira MCP Server for Cursor