Jira Context MCP

Jira 的模型上下文协议 (MCP) 实现允许您：

• 输入 Jira 票证链接以获取问题详细信息并指示 Cursor 修复它

• 检索指定 Jira 项目内分配给您的所有工单

• 根据特定问题类型过滤 Jira 问题并自动引导 Cursor 解决这些问题

• 与 Jira 的 API 无缝集成，实现自动化和效率

设置

先决条件

• Node.js 20.17.0 或更高版本

• 具有 API 访问权限的 Jira 帐户

• Jira API 令牌（可以在Atlassian API 令牌中生成）

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Jira Context MCP：

手动安装

1. 克隆此存储库：

   git clone https://github.com/yourusername/Jira-Context-MCP.git cd Jira-Context-MCP

2. 安装依赖项：

   npm install # or if you use pnpm pnpm install

3. 根据示例创建一个.env文件：

   cp .env.example .env

4. 使用您的 Jira 详细信息编辑.env文件：

   JIRA_BASE_URL=https://your-domain.atlassian.net JIRA_USERNAME=your-email@example.com JIRA_API_TOKEN=your-api-token-here HTTP_PORT=3000

建造

使用以下方式构建项目：

用法

启动服务器

启动 HTTP 服务器：

或者使用CLI模式：

使用光标连接

1. 在 Cursor 中，打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）

2. 输入**“连接到 MCP 服务器”**

3. 选择**“连接到 MCP 服务器”**

4. 输入服务器 URL（默认值： http://localhost:3000/sse ）

可用工具

连接后，您可以在 Cursor 中使用以下工具：

1.获取 Jira 问题详情

获取有关特定 Jira 问题的详细信息：

2. 获取分配的问题

检索特定项目中分配给您的问题：

3. 按类型获取问题

按类型（Bug、Story、Epic 等）过滤问题：

4. 获取项目

列出所有可用的项目：

5. 获取问题类型

列出所有可用的问题类型：

6. 获取最近的机票变更

检索项目中指定时间段内（例如过去 7 天）的票证所做的更改：

命令示例

🚀 **Jira MCP 服务器 + Cursor IDE = 您的 AI 驱动型 Jira 助手！**它如何让开发者更智能地工作：

📂 “列出我有权访问的所有 Jira 项目”
→ AI 立即获取所有可用项目
不再需要手动搜索！

📋 “列出项目中的所有问题”
→ 人工智能检索所有未完成的票证
轻松保持井然有序！

🐛 “仅过滤错误或变更请求并修复它们”
→ AI 识别并引导 Cursor 解决这些问题
通过自动化更快地解决问题！

✅ “查找分配给我的所有票证并修复它们”
→ AI 提取你的任务并让 Cursor 处理
轻松掌控您的工作！

🔍 “获取 Jira 问题 PROJECT-123 的详细信息”
→ 人工智能可在几秒钟内获取完整的问题信息
不再需要切换标签！

📊 “过去 7 天内，PROJECT 中的票证发生了什么变化？”
→ AI 跟踪最近的更新并突出显示关键变化
不再需要手动检查票务历史记录！

🔥 **TL;DR：**你的 AI 现在会说 Jira + Cursor 了！获取项目、筛选问题、跟踪变更和修复错误——所有操作都在你的 IDE 中完成。
从积压工作到错误修复，MCP Server 让 Jira 为您服务！

示例工作流程

修复特定错误

1. 在 Cursor 中连接到 Jira MCP 服务器。

2. 获取问题详情：

   /get_issue issueKey:PROJECT-123

3. 查看问题详细信息并指示 Cursor 修复它：

   Fix the bug described in PROJECT-123

处理你分配的问题

1. 在 Cursor 中连接到 Jira MCP 服务器。

2. 检索您分配的问题：

   /get_assigned_issues projectKey:PROJECT

3. 请 Cursor 帮助解决以下问题之一：

   Help me solve the first issue in my assigned list

修复项目中的所有错误

1. 在 Cursor 中连接到 Jira MCP 服务器。

2. 检索所有错误问题：

   /get_issues_by_type issueType:Bug projectKey:PROJECT

3. 指示光标：

   Help me fix these bugs one by one

审查最近的更改

1. 在 Cursor 中连接到 Jira MCP 服务器。

2. 检索最近的票证更新：

   /get_recent_changes projectKey:PROJECT maxDays:7

3. 查看更改以了解最新的修改。

发展

项目结构

• src/ ——源代码

  • services/ -Jira API 服务

  • types/ - TypeScript 类型定义

  • utils/ ——实用函数

  • server.ts - MCP 服务器实现

  • index.ts - 应用程序入口点

  • cli.ts ——CLI入口点

添加新工具

要添加新工具，请编辑src/server.ts文件并在registerTools方法中添加新的工具定义。

执照

麻省理工学院

作者

拉胡尔·戴伊 - @rahulthedevil