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
• Учетная запись Atlassian с доступом к API

Установка

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

Использование

После настройки MCP в Cursor IDE вы сможете взаимодействовать с продуктами Atlassian непосредственно из IDE. Например:

• Искать задачи JIRA, связанные с вашей текущей задачей
• Создавать новые задачи для обнаруженных ошибок
• Просматривать документацию в Confluence
• Создавать или обновлять файлы в репозиториях BitBucket
• Создавать Pull Requests для ваших изменений
• Учитывать время, затраченное на задачи

Разработка

Для запуска MCP в режиме разработки с автоматической перезагрузкой:

npm run dev

Структура проекта

├── 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

Лицензия

MIT