# 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