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 的模型上下文协议 (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
   # 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
   

构建

使用以下命令构建项目：

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. 键入 "Connect to MCP Server"
3. 选择 "Connect to MCP Server"
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 Server + Cursor IDE = 您的 AI 驱动的 Jira 助手！ 以下是它如何使开发人员更智能地工作：

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

📋 "列出 PROJECT 中的所有问题" → AI 检索所有未解决的工单 无需努力即可保持井井有条！

🐛 "仅过滤 Bug 或变更请求并修复它们" → AI 识别并指示 Cursor 解决它们 通过自动化更快地修复问题！

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

🔍 "获取 Jira 问题 PROJECT-123 的详细信息" → AI 在几秒钟内获取完整的工单信息 不再需要切换选项卡！

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

🔥 TL;DR: 您的 AI 现在会说 Jira + Cursor！ 获取项目、过滤问题、跟踪更改和修复错误 - 全部在您的 IDE 中。 从 backlog 到 bug 修复，MCP Server 让 Jira 为您服务！

示例工作流程

修复特定 Bug

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
   

修复项目中的所有 Bug

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

   /get_issues_by_type issueType:Bug projectKey:PROJECT
   

3. 指示 Cursor：

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

许可证

MIT

作者

Rahul Dey - @rahulthedevil