Atlassian MCP for Cursor IDE

Managed Code Plugin (MCP) for Cursor IDE, providing integration with Atlassian products: JIRA, Confluence and BitBucket.

Possibilities

JIRA integration

• Searching for tasks using JQL

• Getting detailed information about tasks

• Creating new tasks

• Adding comments to tasks

• Workflow management

• Integration with Tempo for time tracking

• Working with projects and epics

Confluence integration

• Getting page content

• Searching Pages Using CQL

• Getting information about spaces

• Creating new pages

• Updating existing pages

• Working with attachments and comments

BitBucket integration

• Getting information about repositories

• Getting information about branches

• Creating new branches

• Working with Pull Requests

• Getting file contents

• Creating and editing files

• Integration with Pipelines

Related MCP server: Jira Context MCP Server

Requirements

• Node.js (v14 or higher)

• npm (v6 or higher)

• Cursor IDE

• Atlassian account with API access

Installation

1. Clone the repository:

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

2. Install dependencies:

   npm install

3. Set up Atlassian credentials:

   • Copy .env.example to .env

   • Update the values with your Atlassian credentials

4. Assemble the project:

   npm run build

5. Start the MCP server:

   npm start

Setting up Cursor IDE

1. Open Cursor IDE

2. Go to Settings > Features > MCP Servers

3. Add a new MCP server with the following details:

   • Name: Atlassian MCP

   • Type: HTTP

   • URL: http://localhost:3000/mcp

Usage

Once you have set up MCP in Cursor IDE, you will be able to interact with Atlassian products directly from the IDE. For example:

• Search JIRA issues related to your current issue

• Create new tasks for detected bugs

• View documentation in Confluence

• Create or update files in BitBucket repositories

• Create Pull Requests for your changes

• Keep track of time spent on tasks

Development

To run MCP in development mode with automatic reboot:

npm run dev

Project structure

├── src/                   # Исходный код
│   ├── index.ts           # Точка входа
│   ├── mcp/               # MCP инструменты
│   │   ├── jiraTools.ts   # Инструменты для JIRA
│   │   ├── confluenceTools.ts # Инструменты для Confluence
│   │   └── bitbucketTools.ts # Инструменты для BitBucket
│   └── services/          # Сервисы для работы с API Atlassian
│       ├── AtlassianBaseService.ts # Базовый сервис
│       ├── JiraService.ts # Сервис для работы с JIRA API
│       ├── ConfluenceService.ts # Сервис для работы с Confluence API
│       └── BitbucketService.ts # Сервис для работы с BitBucket API
├── dist/                  # Скомпилированный код
├── .env                   # Конфигурация окружения
├── .env.example           # Пример конфигурации
├── package.json           # Зависимости и скрипты
└── tsconfig.json          # Конфигурация TypeScript

License

MIT