MCP 服务器

Atlassian MCP

用于 Cursor IDE 的托管代码插件，提供与 Atlassian 产品（JIRA、Confluence、BitBucket）的集成，使开发人员能够直接从 IDE 搜索任务、创建新问题、查看文档和管理代码仓库。

README

Atlassian MCP for Cursor IDE

适用于 Cursor IDE 的 Managed Code Plugin (MCP)，提供与 Atlassian 产品（JIRA、Confluence 和 BitBucket）的集成。

功能

JIRA 集成

使用 JQL 搜索任务
获取任务的详细信息
创建新任务
向任务添加评论
管理工作流程
与 Tempo 集成以进行时间跟踪
处理项目和 Epic

Confluence 集成

获取页面内容
使用 CQL 搜索页面
获取有关空间的信息
创建新页面
更新现有页面
处理附件和评论

BitBucket 集成

获取有关存储库的信息
获取有关分支的信息
创建新分支
处理 Pull Requests
获取文件内容
创建和编辑文件
与 Pipelines 集成

要求

Node.js (v14 或更高版本)
npm (v6 或更高版本)
Cursor IDE
具有 API 访问权限的 Atlassian 帐户

安装

克隆存储库：

git clone https://github.com/solidus-/atlassian-cursor-mcp.git
cd atlassian-cursor-mcp

安装依赖项：
```
npm install
```
配置 Atlassian 凭据：
- 将 .env.example 复制到 .env
- 使用您的 Atlassian 凭据更新值
构建项目：
```
npm run build
```
启动 MCP 服务器：
```
npm start
```

配置 Cursor IDE

打开 Cursor IDE
转到 Settings > Features > MCP Servers
添加一个新的 MCP 服务器，包含以下数据：
- 名称：Atlassian MCP
- 类型：HTTP
- URL：http://localhost:3000/mcp

使用

在 Cursor IDE 中配置 MCP 后，您将能够直接从 IDE 与 Atlassian 产品进行交互。例如：

搜索与您当前任务相关的 JIRA 任务
为发现的错误创建新任务
在 Confluence 中查看文档
在 BitBucket 存储库中创建或更新文件
为您的更改创建 Pull Requests
跟踪花费在任务上的时间

开发

要在具有自动重新加载功能的开发模式下启动 MCP：

npm run dev

项目结构

├── src/                   # 源代码
│   ├── index.ts           # 入口点
│   ├── mcp/               # MCP 工具
│   │   ├── jiraTools.ts   # JIRA 工具
│   │   ├── confluenceTools.ts # Confluence 工具
│   │   └── bitbucketTools.ts # BitBucket 工具
│   └── services/          # 用于处理 Atlassian API 的服务
│       ├── AtlassianBaseService.ts # 基础服务
│       ├── JiraService.ts # 用于处理 JIRA API 的服务
│       ├── ConfluenceService.ts # 用于处理 Confluence API 的服务
│       └── BitbucketService.ts # 用于处理 BitBucket API 的服务
├── dist/                  # 编译后的代码
├── .env                   # 环境配置
├── .env.example           # 配置示例
├── package.json           # 依赖项和脚本
└── tsconfig.json          # TypeScript 配置