Jira Context MCP

smithery 徽章在 MseeP 上验证

一个为 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)
输入 "Connect to MCP Server"
选择 "Connect to MCP Server"
输入服务器 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 中完成。
从待办事项到错误修复，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