Jira Context MCP

<figure> <a href="https://glama.ai/mcp/servers/a8ob8depqc"> <img width="380" height="200" src="https://glama.ai/mcp/servers/a8ob8depqc/badge" /> </a> </figure>

这是一个针对 Jira 的 Model Context Protocol (MCP) 实现，它允许你：

• 输入 Jira 问题链接以获取问题详情并指示 Cursor 解决它
• 检索指定 Jira 项目中分配给你的所有工单
• 根据特定的问题类型筛选 Jira 问题，并自动指示 Cursor 解决它们
• 无缝集成 Jira 的 API 以实现自动化和提高效率

设置

前提条件

• Node.js 20.17.0 或更高版本
• 具有 API 访问权限的 Jira 账户
• 一个 Jira API 令牌（可以在 Atlassian API Tokens 生成）

安装

通过 Smithery 安装

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

npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude

手动安装

1. 克隆此仓库：

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

2. 安装依赖项：

   npm install
   # 或者如果你使用 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
   

构建

构建项目：

npm run build
# or
pnpm build

使用

启动服务器

启动 HTTP 服务器：

npm start
# or
pnpm start

或者使用 CLI 模式：

npm run start:cli
# or
pnpm start:cli

连接到 Cursor

1. 在 Cursor 中打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）
2. 输入 "连接到 MCP 服务器"
3. 选择 "连接到 MCP 服务器"
4. 输入服务器 URL（默认: http://localhost:3000/sse）

可用工具

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

1. 获取 Jira 问题详情

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

/get_issue issueKey:PROJECT-123

2. 获取已分配的问题

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

/get_assigned_issues projectKey:PROJECT maxResults:10

3. 按类型获取问题

按类型（Bug、Story、Epic 等）筛选问题：

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. 获取项目

列出所有可用的项目：

/get_projects

5. 获取问题类型

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

/get_issue_types

6. 获取最近的工单更改

检索项目中在指定时间段内（例如，过去 7 天）对工单所做的更改：

/get_recent_changes projectKey:PROJECT maxDays:7

命令示例

🚀 Jira MCP 服务器 + Cursor IDE = 你的 AI 驱动的 Jira 助手！ 它如何使开发人员更智能地工作：

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

📋 "列出PROJECT中的所有问题"
→ AI检索所有开放的工单
无需费力即可保持组织性！

🐛 "仅筛选错误或变更请求并修复它们"
→ AI识别并将光标定位以解决这些问题
通过自动化更快地解决问题！

✅ "查找分配给我的所有工单并修复它们"
→ AI拉取您的任务并让光标处理它们
毫不费力地掌握工作！

🔍 "获取Jira问题PROJECT-123的详细信息"
→ AI几秒钟内获取完整的问题信息
无需再切换标签页！

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

🔥 TL;DR: 您的AI现在会说Jira + Cursor！在IDE内部获取项目、筛选问题、跟踪更改和修复错误。
从积压到错误修复，MCP Server使Jira为您工作！

示例工作流程

修复特定错误

1. 在Cursor中连接到Jira MCP服务器。
2. 获取问题详情：

   /get_issue issueKey:PROJECT-123
   

3. 查看问题详情并指示Cursor修复它：

   修复PROJECT-123中描述的错误
   

处理分配给您的问题

1. 在Cursor中连接到Jira MCP服务器。
2. 检索分配给您的问题：

   /get_assigned_issues projectKey:PROJECT
   

3. 请Cursor帮助您解决其中一个问题：

   帮我解决分配列表中的第一个问题
   

修复项目中的所有错误

1. 在Cursor中连接到Jira MCP服务器。
2. 检索所有错误问题：

   /get_issues_by_type issueType:Bug projectKey:PROJECT
   

3. 指示Cursor：

   帮我逐一修复这些错误
   

审查最近的更改

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方法中添加新的工具定义。

许可证

MIT

作者

Rahul Dey - @rahulthedevil