# Email MCP Server

HTTP/SSE wrapper для [nikolausm/imap-mcp-server](https://github.com/nikolausm/imap-mcp-server), обеспечивающий удалённый доступ через Claude Web и другие HTTP-клиенты MCP.

## Возможности

- 📧 **Полноценная работа с почтой**: чтение, поиск, отправка, ответ, пересылка
- 🔐 **Безопасное хранение**: AES-256 шифрование учётных данных
- 🌐 **Удалённый доступ**: HTTP/SSE транспорт для Claude Web
- 📱 **15+ провайдеров**: Gmail, Outlook, Yahoo, Yandex, Mail.ru и др.
- 🔄 **Multi-account**: Поддержка нескольких почтовых аккаунтов

## Архитектура

```
┌─────────────────────────────────────────────────────┐
│                  HTTP/SSE Wrapper                    │
│                  (Python/aiohttp)                    │
├─────────────────────────────────────────────────────┤
│                                                      │
│   HTTP/SSE ←→ STDIO Bridge ←→ imap-mcp-server       │
│                                                      │
└─────────────────────────────────────────────────────┘
```

## Быстрый старт

### Локально для Claude Desktop

```bash
# Клонировать репозиторий
git clone https://github.com/nikolausm/imap-mcp-server.git
cd imap-mcp-server

# Установить и собрать
npm install
npm run build

# Настроить аккаунты через web wizard
npm run setup
```

Добавить в `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "imap-email": {
      "command": "node",
      "args": ["/path/to/imap-mcp-server/dist/index.js"]
    }
  }
}
```

### Удалённый сервер (Docker)

```bash
# Собрать и запустить
docker-compose up -d

# Проверить здоровье
curl http://localhost:3008/health
```

### Через Gateway (Claude Web)

URL для Custom Connector:
```
https://mcp.svsfinpro.ru/email/sse
```

## API Endpoints

| Endpoint | Метод | Описание |
|----------|-------|----------|
| `/` | GET | Информация о сервере |
| `/health` | GET | Health check |
| `/sse` | GET | SSE endpoint для установления соединения |
| `/mcp` | POST | Streamable HTTP endpoint |
| `/messages` | POST | Legacy SSE messages endpoint |

## MCP Инструменты

### Управление аккаунтами
- `imap_add_account` - Добавить почтовый аккаунт
- `imap_list_accounts` - Список аккаунтов
- `imap_remove_account` - Удалить аккаунт
- `imap_connect` - Подключиться к аккаунту
- `imap_disconnect` - Отключиться

### Работа с письмами
- `imap_search_emails` - Поиск писем
- `imap_get_email` - Получить письмо
- `imap_get_latest_emails` - Последние письма
- `imap_mark_as_read` / `imap_mark_as_unread` - Пометить как прочитанное
- `imap_delete_email` - Удалить письмо

### Отправка писем
- `imap_send_email` - Отправить письмо
- `imap_reply_to_email` - Ответить на письмо
- `imap_forward_email` - Переслать письмо

### Папки
- `imap_list_folders` - Список папок
- `imap_folder_status` - Статус папки
- `imap_get_unread_count` - Количество непрочитанных

## Настройка провайдеров

### Gmail
1. Включить 2FA
2. Создать App Password: https://myaccount.google.com/apppasswords
3. IMAP: `imap.gmail.com:993`
4. SMTP: `smtp.gmail.com:465`

### Yandex
1. Создать пароль приложения
2. IMAP: `imap.yandex.ru:993`
3. SMTP: `smtp.yandex.ru:465`

### Mail.ru
1. IMAP: `imap.mail.ru:993`
2. SMTP: `smtp.mail.ru:465`

## Deployment

### На сервер 217.199.253.8

```bash
./deploy.sh
```

### Добавить в nginx gateway

Скопировать `nginx-mcp-email.conf` в конфигурацию сервера.

## Безопасность

- ⚠️ **НИКОГДА** не используйте основной пароль - только App Passwords
- 🔐 Учётные данные шифруются AES-256
- 📁 Хранятся в Docker volume `email-mcp-accounts`
- 🔒 HTTPS через nginx gateway

## Переменные окружения

| Переменная | Описание | По умолчанию |
|------------|----------|--------------|
| `HOST` | Адрес сервера | `0.0.0.0` |
| `PORT` | Порт | `8080` |
| `IMAP_SERVER_PATH` | Путь к imap-mcp-server | `/app/imap-mcp-server/dist/index.js` |
| `LOG_LEVEL` | Уровень логирования | `INFO` |

## Troubleshooting

### Контейнер не запускается
```bash
docker logs email-mcp-server
```

### Проблемы с подключением к почте
- Проверьте App Password
- Убедитесь что IMAP включен в настройках почты
- Проверьте firewall

## License

MIT