Atlassian MCP 用于 Cursor IDE

Managed Code Plugin (MCP) 为 Cursor IDE 提供与 Atlassian 产品的集成：JIRA、Confluence 和 BitBucket。

功能

JIRA 集成

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

Confluence 集成

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

BitBucket 集成

• 获取仓库信息
• 获取分支信息
• 创建新分支
• 处理 Pull Requests
• 获取文件内容
• 创建和编辑文件
• 与 Pipelines 集成

要求

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

安装

1. 克隆仓库：

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

2. 安装依赖项：

   npm install

3. 配置 Atlassian 凭据：

   • 将 .env.example 复制为 .env
   • 使用您的 Atlassian 凭据更新值

4. 构建项目：

   npm run build

5. 启动 MCP 服务器：

   npm start

配置 Cursor IDE

1. 打开 Cursor IDE
2. 进入 Settings > Features > MCP Servers
3. 添加一个新的 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 配置## 许可证

MIT