AI导哈

JIRA集成服务器

一个集成JIRA与Cursor AI的模型上下文协议（MCP）服务器，允许直接从AI聊天中获取票据、识别开发任务并与JIRA项目交互。

  • by adam-israel
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 adam-israel/jira-mcp-server

使用说明

JIRA MCP 服务器

一个模型上下文协议（MCP）服务器，它将JIRA与Cursor AI集成，使您能够从AI聊天界面直接获取工单、识别开发任务，并与您的JIRA项目进行交互。

特性/功能

  • 🎫（门票、入场券等的符号，具体含义需结合上下文） 获取单个JIRA工单 包含全部细节
  • 📋 翻译成中文是：“清单”或“待办事项列表”。 列出你被分配的工单 按最新更新排序
  • 🔍 搜索票据/票务 使用JQL（JIRA查询语言）
  • 📊（图表） 列出项目工单 对于你有权参与的任何项目
  • 🤖 机器人（或机器人表情） 自动任务识别 来自工单描述和子任务
  • ✨（这个符号在中文里通常没有直接对应的翻译，它常用来表示闪耀、亮点或兴奋等情感，可以根据上下文灵活翻译为“闪闪发光”、“亮点”或保持原样使用以传达特定氛围。） 格式美观的输出 针对人工智能交互进行了优化

先决条件

  • 已安装 Node.js 18+
  • 一个具有API访问权限的JIRA账户
  • JIRA API令牌（请参阅下面的设置说明）

安装

服务器已经安装并编译完成。目录结构如下：

jira-mcp-server/
├── src/
│   └── index.ts          # TypeScript source code
├── dist/
│   └── index.js          # Compiled JavaScript (ready to use)
├── package.json
├── tsconfig.json
└── README.md

配置

第一步：获取您的JIRA API令牌

  1. 访问 https://id.atlassian.com/manage-profile/security/api-tokens
  2. 点击 创建API令牌
  3. 给它起个名字（例如，“MCP 服务器”）
  4. 立即复制令牌（您将再也看不到它了！）

步骤2：更新MCP配置

MCP配置文件位于 ~/.cursor/mcp.json用你的详细信息更新它：

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": [
        "/Users/adamisrael/git-projects/heatwave-dashboard/jira-mcp-server/dist/index.js"
      ],
      "env": {
        "JIRA_HOST": "gieman.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

重要提示： 替换以下占位符：

  • JIRA_EMAIL您的JIRA账户电子邮箱地址
  • JIRA_API_TOKEN您在步骤1中创建的API令牌

步骤3：重启光标

更新后 mcp.json，你需要 重启 Cursor 以便更改生效。

使用方法

配置完成后并重启Cursor，您可以在AI聊天中使用以下工具：

1. 获取特定工单

Fetch JIRA ticket AI-MCP-123 and tell me what needs to be done

或者

Show me the details of ticket AI-MCP-456

2. 列出您分配的工单

Show me all my JIRA tickets

或者

What tickets are assigned to me?

3. 列出项目工单

List all tickets in the AI-MCP project

或者

Show me recent tickets from project AI-MCP

4. 使用JQL进行搜索

Search JIRA for tickets with status "In Progress" in project AI-MCP

或者

Find all high priority bugs assigned to me

可用工具

MCP服务器向Cursor提供了以下工具：

读取操作

工具 描述 参数
fetch_jira_ticket 获取特定票据的详细信息 ticketKey （字符串）
list_my_tickets 列出分配给你的票据 maxResults （数字，可选）
list_project_tickets 列出项目的工单 projectKey （字符串）， maxResults （数字，可选）
search_jira_tickets 使用JQL进行搜索 jql （字符串）， maxResults （数字，可选）

写操作

工具 描述 参数
add_jira_comment 在工单上添加评论 ticketKey （字符串）， comment （字符串）
update_jira_ticket 更新工单字段（摘要、描述） ticketKey （字符串）， updates (对象)
assign_jira_ticket 分配/取消分配工单 ticketKey （字符串）， assigneeEmail (字符串，可选)

开发任务识别

服务器自动分析工单，并从中提取开发任务：

  1. 子任务 - 已解析并列出其键值
  2. 描述要点（或：项目描述要点） - 提取编号列表或项目符号列表
  3. 问题类型启发式方法 - 根据错误/故事/功能的分类提供智能建议

示例工作流程

以下是使用JIRA MCP服务器的典型工作流程：

读取操作

  1. 列出您的票据：

    Show me my JIRA tickets

  2. 获取票务详情：

    Fetch ticket AM-1 and break down the development tasks

  3. 实施变更：

    Based on this ticket, update the database schema to add the new user_preferences table

  4. 搜索相关工作：

    Search JIRA for other tickets mentioning "user preferences" in project AI-MCP

写操作

  1. 添加评论：

    Add this implementation plan as a comment to ticket AM-1

  2. 更新工单描述：

    Update the description of ticket AM-1 with the technical specifications

  3. 分配工单：

    Assign ticket AM-1 to me

  4. 文件进度：

    Add a comment to AM-1: "Completed Phase 1 - Table selection UI implemented"

故障排除

服务器无法工作

  1. 检查日志打开 Cursor 的开发者控制台（帮助 > 切换开发者工具）
  2. 验证配置确保 mcp.json 具有正确的路径和凭据
  3. 测试API令牌尝试直接访问JIRA API：
    curl -u your-email@example.com:your-api-token \
  https://gieman.atlassian.net/rest/api/3/myself

认证错误

  • 确认你的电子邮件地址正确无误
  • 确保API令牌有效且未过期
  • 确认您能够访问JIRA实例

找不到票

  • 确保您拥有正确的项目密钥（例如。， AI-MCP 不是 AIMCP)
  • 确认您有查看这些票据的权限
  • 验证票据是否存在，以及您是否使用了正确的密钥格式

安全注意事项

  • 永远不要把自己的 mcp.json 使用真实的凭据进行版本控制
  • API令牌应像密码一样对待
  • 考虑为不同用途使用不同的代币
  • 从 Atlassian 管理控制台中撤销您不再使用的令牌

变革后的重建

如果你修改了TypeScript源代码：

cd /Users/adamisrael/git-projects/heatwave-dashboard/jira-mcp-server
npm run build

然后重新启动 Cursor。

JQL 快速参考指南

一些有用的JQL查询：

  • assignee = currentUser() - 你们的票
  • project = AI-MCP - 项目中的所有票据
  • status = "In Progress" - 进行中的票务
  • priority = High - 高优先级工单
  • created >= -7d - 在过去7天内创建
  • updated >= -1d ORDER BY updated DESC - 今日已更新

结合使用 AND， OR以及用于复杂查询的括号。

支持

对于问题或疑问：

  1. 在 Cursor 开发者控制台中检查错误信息
  2. 验证您的JIRA API令牌是否有效
  3. 确保您在JIRA中拥有适当的权限
  4. 查阅MCP SDK文档：https://github.com/modelcontextprotocol

许可证

这个MCP服务器是您heatwave-dashboard项目的一部分，并遵循相同的许可协议。

相关 MCP