返回市场
杰拉上下文MCP

杰拉上下文MCP

作者:rahulthedevil24 星标更新:2025-07-10

项目介绍

MseeP.ai 安全评估徽章

Jira 上下文 MCP

CodeQL 高级 smithery 徽章 在 MseeP 上验证

<figure> <a href="https://glama.ai/mcp/servers/a8ob8depqc"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=2753542417,338883021&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a> </figure>

这是一个针对 Jira 的模型上下文协议(MCP)实现,它允许您:

  • 输入一个 Jira 工单链接以获取工单详情并指示 Cursor 进行修复
  • 获取分配给您的所有工单,这些工单属于指定的 Jira 项目
  • 根据特定的工单类型过滤 Jira 工单,并自动引导 Cursor 解决它们
  • 无缝集成到 Jira 的 API 中,以实现自动化和效率

设置

先决条件

  • Node.js 20.17.0 或更高版本
  • 具有 API 访问权限的 Jira 账户
  • Jira API 密钥(可以在 Atlassian API 密钥 页面生成)

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Jira 上下文 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
# 或者
pnpm build

使用

启动服务器

启动 HTTP 服务器:

npm start
# 或者
pnpm start

或者使用 CLI 模式:

npm run start:cli
# 或者
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 项目”
→ AI 即刻获取所有可用项目
无需手动搜索!

📋 “列出 PROJECT 中的所有工单”
→ AI 获取所有开放的工单
轻松保持组织!

🐛 “仅筛选 Bug 或变更请求并修复它们”
→ AI 识别并引导 Cursor 解决它们
通过自动化更快地修复问题!

“查找分配给我的所有工单并修复它们”
→ AI 提取您的任务并让 Cursor 处理它们
毫不费力地掌控您的工作!

🔍 “获取 Jira 工单 PROJECT-123 的详情”
→ AI 在几秒钟内获取完整的工单信息
无需切换标签页!

📊 “在过去 7 天里,PROJECT 中的工单发生了什么变化?”
→ AI 跟踪最近的更新并突出显示关键变化
无需手动检查工单历史记录!

🔥 TL;DR: 您的 AI 现在会说 Jira + Cursor!获取项目、筛选工单、跟踪更改和修复错误——全部都在您的 IDE 内。
从待办事项到错误修复,MCP 服务器让 Jira 为您服务!

示例工作流程

修复特定 Bug

  1. 在 Cursor 中连接到 Jira MCP 服务器。
  2. 获取工单详情:
    /get_issue issueKey:PROJECT-123
    
  3. 查看工单详情并指示 Cursor 进行修复:
    修复 PROJECT-123 中描述的 Bug
    

处理分配给您的工单

  1. 在 Cursor 中连接到 Jira MCP 服务器。
  2. 获取分配给您的工单:
    /get_assigned_issues projectKey:PROJECT
    
  3. 请求 Cursor 帮助解决其中一个工单:
    帮我解决分配给我列表中的第一个工单
    

修复项目中的所有 Bug

  1. 在 Cursor 中连接到 Jira MCP 服务器。
  2. 获取所有 Bug 工单:
    /get_issues_by_type issueType:Bug projectKey:PROJECT
    
  3. 指示 Cursor:
    帮我依次修复这些 Bug
    

审查最近的变化

  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