# Jira上下文信息服务器
## 基本信息
- Slug: `rahulthedevil-jira-context-mcp`
- Source: modelscope
- Publisher: @rahulthedevil/Jira-Context-MCP
- Categories: customer-support / developer-tools / monitoring
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@rahulthedevil/Jira-Context-MCP
## 简介
MCP服务器向AI编码代理（如Cursor）提供Jira工单信息。
## 安装提示

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

## MCP Server 详情

# Jira Context MCP
[![CodeQL Advanced](https://github.com/rahulthedevil/Jira-Context-MCP/actions/workflows/codeql.yml/badge.svg)](https://github.com/rahulthedevil/Jira-Context-MCP/actions/workflows/codeql.yml)
[![smithery badge](https://smithery.ai/badge/@rahulthedevil/Jira-Context-MCP)](https://smithery.ai/server/@rahulthedevil/Jira-Context-MCP)
<figure>
    <a href="https://glama.ai/mcp/servers/a8ob8depqc">
     <img width="380" height="200" src="https://glama.ai/mcp/servers/a8ob8depqc/badge" />
   </a>
</figure>

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

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

## 设置

### 前提条件

- Node.js 20.17.0 或更高版本
- 具有 API 访问权限的 Jira 账户
- 一个 Jira API 令牌（可以在 [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens) 生成）

### 安装

#### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@rahulthedevil/Jira-Context-MCP) 自动为 Claude Desktop 安装 Jira Context MCP：

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


#### 手动安装

1. 克隆此仓库：
   ```bash
   git clone https://github.com/yourusername/Jira-Context-MCP.git
   cd Jira-Context-MCP
   ```

2. 安装依赖项：
   ```bash
   npm install
   # 或者如果你使用 pnpm
   pnpm install
   ```

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

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

### 构建

构建项目：

```bash
npm run build
# or
pnpm build
```


## 使用

### 启动服务器

启动 HTTP 服务器：

```bash
npm start
# or
pnpm start
```


或者使用 CLI 模式：

```bash
npm run start:cli
# or
pnpm start:cli
```


### 连接到 Cursor

1. 在 Cursor 中打开命令面板（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 助手！** 它如何使开发人员更智能地工作：

📂 **"列出我有访问权限的所有Jira项目"**  
→ AI即时获取所有可用项目  
不再需要手动搜索！

📋 **"列出PROJECT中的所有问题"**  
→ AI检索所有开放的工单  
无需费力即可保持组织性！

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

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

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

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

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

## 示例工作流程

### 修复特定错误

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

### 处理分配给您的问题

1. 在Cursor中连接到Jira MCP服务器。
2. 检索分配给您的问题：
   ```
   /get_assigned_issues projectKey:PROJECT
   ```
3. 请Cursor帮助您解决其中一个问题：
   ```
   帮我解决分配列表中的第一个问题
   ```

### 修复项目中的所有错误

1. 在Cursor中连接到Jira MCP服务器。
2. 检索所有错误问题：
   ```
   /get_issues_by_type issueType:Bug projectKey:PROJECT
   ```
3. 指示Cursor：
   ```
   帮我逐一修复这些错误
   ```

### 审查最近的更改

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`方法中添加新的工具定义。

## 许可证

MIT

## 作者

Rahul Dey - [@rahulthedevil](https://github.com/rahulthedevil)