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

1. 安装依赖项：

   npm install
   # or if you use pnpm
   pnpm install

1. 创建一个 .env 基于示例的文件：

   cp .env.example .env

1. 编辑 .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

1. 查看问题详细信息并指示Cursor进行修复：

   Fix the bug described in PROJECT-123

处理分配的问题

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

   /get_assigned_issues projectKey:PROJECT

1. 请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

1. 指示光标：

   Help me fix these bugs one by one

查看最近的更改

1. 在Cursor中连接到Jira MCP服务器。
2. 检索最近的工单更新：

   /get_recent_changes projectKey:PROJECT maxDays:7

1. 查看更改以了解修改的最新情况。

发展

项目结构

• src/ -源代码

- services/ -Jira API服务 - types/ -TypeScript类型定义 - utils/ -实用功能 - server.ts -MCP服务器实现 - index.ts -应用程序入口点 - cli.ts -CLI入口点

添加新工具

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

许可证

麻省理工学院

作者

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