Jira上下文信息服务器

@rahulthedevil/Jira-Context-MCP

0 Stars 379 次浏览 rahulthedevil 更新于 2026-08-23

MCP服务器向AI编码代理（如Cursor）提供Jira工单信息。

交流协作工具开发者工具

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

Jira Context MCP

这是一个针对 Jira 的 Model Context Protocol (MCP) 实现，它允许你：

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

设置

前提条件

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

安装

通过 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
# or
pnpm build

使用

启动服务器

启动 HTTP 服务器：

npm start
# or
pnpm start

或者使用 CLI 模式：

npm run start:cli
# or
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检索所有开放的工单
无需费力即可保持组织性！

🐛 "仅筛选错误或变更请求并修复它们"
→ AI识别并将光标定位以解决这些问题
通过自动化更快地解决问题！

✅ "查找分配给我的所有工单并修复它们"
→ AI拉取您的任务并让光标处理它们
毫不费力地掌握工作！

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

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

🔥 TL;DR: 您的AI现在会说Jira + Cursor！在IDE内部获取项目、筛选问题、跟踪更改和修复错误。
从积压到错误修复，MCP Server使Jira为您工作！

示例工作流程

修复特定错误

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

处理分配给您的问题

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

检索分配给您的问题：

/get_assigned_issues projectKey:PROJECT

请Cursor帮助您解决其中一个问题：

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

修复项目中的所有错误

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

检索所有错误问题：

/get_issues_by_type issueType:Bug projectKey:PROJECT

指示Cursor：
```
帮我逐一修复这些错误
```

审查最近的更改

在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

查看源码项目主页