用于 Cursor 的 Jira MCP 服务器

一个基于 TypeScript 的 MCP 服务器，与 Jira 集成，允许 Cursor 与 Jira 工单进行交互。

功能

• 列出 Jira 工单
• 获取工单详情
• 创建新工单
• 添加评论到工单
• 更新工单状态
• 完全支持 Cursor 集成的 MCP 协议

设置

1. 安装依赖:

npm install

2. 基于 .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 token:

1. 登录到 https://id.atlassian.com/manage/api-tokens
2. 点击 "创建 API token"
3. 复制 token 并将其粘贴到您的 .env 文件中

开发

运行开发服务器:

npm run dev

构建和运行

构建项目:

npm run build

启动服务器:

npm start

Cursor 集成

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

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

1. 构建项目:

npm run build

2. 打开 Cursor 的设置:

   • 点击 Cursor 菜单
   • 选择 "Settings" (或使用键盘快捷键)
   • 导航到 "Extensions" 或 "Integrations" 部分

3. 添加 MCP 配置:

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

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

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

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

npm start

2. 打开 Cursor 的设置:

   • 点击 Cursor 菜单
   • 选择 "Settings" (或使用键盘快捷键)
   • 导航到 "Extensions" 或 "Integrations" 部分

3. 添加 MCP 配置:

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

在 Cursor 中使用 Jira

配置 MCP 服务器后，您可以直接在 Cursor 中使用 Jira 命令：

• /jira list - 列出您的工单
• /jira view TICKET-123 - 查看工单详情
• /jira create - 创建新工单
• /jira comment TICKET-123 - 添加评论
• /jira status TICKET-123 - 更新工单状态

MCP 协议支持

该服务器实现了 Cursor 所需的 Model-Client-Protocol (MCP)：

• 用于基于命令的集成的 Stdio 通信
• 用于 Jira 操作的工具注册

API 接口

列出工单

GET /api/tickets
Query params:
  - jql (optional): Jira Query Language string

获取工单

GET /api/tickets/:id

创建工单

POST /api/tickets
Body:
{
  "summary": "Ticket summary",
  "description": "Ticket description",
  "projectKey": "PROJECT",
  "issueType": "Task"
}

添加评论

POST /api/tickets/:id/comments
Body:
{
  "body": "Comment text"
}

更新状态

POST /api/tickets/:id/status
Body:
{
  "transitionId": "21" // 要执行的转换的 ID
}