README.md•4.75 kB
# 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