Email MCP Server

HTTP/SSE wrapper для 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

# Клонировать репозиторий
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:

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

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

# Собрать и запустить
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

./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

Контейнер не запускается

docker logs email-mcp-server

Проблемы с подключением к почте

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

License

MIT