AI导哈

Jira上下文MCP协议

一个用于Jira的模型上下文协议实现，能够通过API集成自动化获取问题详情、分配任务和筛选问题类型，提升开发效率。

  • by rahulthedevil
  • TypeScript
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 rahulthedevil/Jira-Context-MCP

使用说明

Jira上下文MCP

Jira的模型上下文协议（MCP）实现，允许您：

  • 输入Jira票证链接以获取问题详细信息，并指示Cursor进行修复
  • 检索指定Jira项目中分配给您的所有票证
  • 根据特定问题类型过滤Jira问题，并自动指示Cursor解决这些问题
  • 与Jira的API无缝集成，实现自动化和效率

设置

先决条件

  • Node.js 20.17.0或更高版本
  • 具有API访问权限的Jira帐户
  • Jira API令牌（可以在 大西洋API代币)

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版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. 编辑 .env 包含Jira详细信息的文件：

    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

与游标连接

  1. 在光标中，打开命令面板（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立即获取所有可用项目
不再手动搜索！

📋 “列出项目中的所有问题”
→ AI检索所有未结门票
不费吹灰之力，保持条理！

🐛 “仅筛选Bug或更改请求并修复它们”
→ AI识别并指示Cursor解决这些问题
通过自动化更快地解决问题！

✅ “找到分配给我的所有门票并修复它们”
→ AI提取您的任务并让Cursor处理它们
零烦恼地专注于你的工作！

🔍 “获取Jira问题PROJECT-123的详细信息”
→ AI在几秒钟内获取完整的问题信息
不再切换标签！

📊 “PROJECT过去7天的门票有什么变化？”
→ AI跟踪最近的更新并突出关键变化
不再手动检查机票历史记录！

🔥 太长，读不下去了 你的AI现在会说Jira+Cursor！在IDE中获取项目、过滤问题、跟踪更改和修复错误。
从积压到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. 检索所有错误问题：
    /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 方法。

许可证

麻省理工学院

作者

拉胡尔·戴- @拉胡尔代维奇

相关 MCP