Jira 上下文 MCP

这是一个针对 Jira 的模型上下文协议（MCP）实现，它允许你：

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

设置

前提条件

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

安装

通过 Smithery 安装

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

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

手动安装

克隆此仓库：

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

安装依赖项：

npm install
# 如果你使用 pnpm
pnpm install

根据示例创建 .env 文件：
```
cp .env.example .env
```

使用你的 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

在 Cursor 中，打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）
输入 "连接到 MCP 服务器"
选择 "连接到 MCP 服务器"
输入服务器 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 获取所有开放工单
无需费力即可保持有序！

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

✅ "找到分配给我的所有工单并修复它们"
→ AI 拉取你的任务并让 Cursor 处理它们
轻松掌握你的工作！

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

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

🔥 TL;DR： 你的 AI 现在会说 Jira + Cursor！在 IDE 内获取项目、筛选问题、跟踪变更和修复 Bug。
从积压工作到 Bug 修复，MCP 服务器让 Jira 为你工作！

示例工作流

修复特定 Bug

在 Cursor 中连接到 Jira MCP 服务器。
获取问题详情：
```
/get_issue issueKey:PROJECT-123
```
查看问题详情并指示 Cursor 进行修复：
```
修复 PROJECT-123 中描述的 Bug
```

处理分配给你的问题

在 Cursor 中连接到 Jira MCP 服务器。

检索分配给你的问题：

/get_assigned_issues projectKey:PROJECT

请求 Cursor 帮助处理其中一个问题：

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

修复项目中的所有 Bug

在 Cursor 中连接到 Jira MCP 服务器。

检索所有 Bug 问题：

/get_issues_by_type issueType:Bug projectKey:PROJECT

指示 Cursor：
```
帮助我逐个修复这些 Bug
```

查看最近的变更

在 Cursor 中连接到 Jira MCP 服务器。

检索最近的工单更新：

/get_recent_changes projectKey:PROJECT maxDays:7

查看变更以了解最新的修改。

开发

项目结构

src/ - 源代码
- services/ - Jira API 服务
- types/ - TypeScript 类型定义
- utils/ - 实用函数
- server.ts - MCP 服务器实现
- index.ts - 应用程序入口点
- cli.ts - CLI 入口点

添加新工具

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

许可证

MIT

作者

Rahul Dey - @rahulthedevil