MCP-сервер Yahoo Mail

Сервер протокола контекста модели (MCP), который позволяет LLM взаимодействовать с Yahoo Mail. Этот сервер позволяет таким инструментам, как Claude Desktop, читать, искать и отправлять электронные письма напрямую через вашу учетную запись Yahoo с использованием безопасной аутентификации OAuth2.

Функции (запланированные)

Чтение писем: получение последних сообщений из папки «Входящие».
Поиск писем: поиск конкретных сообщений по ключевым словам, отправителям или датам.
Отправка писем: создание и отправка электронных писем с использованием SMTP-серверов Yahoo.

Предварительные требования

Node.js: версия 20 или выше.
Приложение Yahoo Developer: вы должны создать приложение на портале разработчиков Yahoo, чтобы получить учетные данные OAuth2.

Создание приложения Yahoo для OAuth2

Перейдите на портал разработчиков Yahoo.
Создайте новое приложение.
Установите разрешения API (API Permissions), включив Mail (чтение и запись).
Установите URI перенаправления (Redirect URI) на https://localhost/callback (или предпочитаемый вами URI).
Запишите свои Client ID и Client Secret.

Настройка

Клонируйте репозиторий:

git clone <repository-url>
cd yahoo-mail-mcp

Установите зависимости:
```
npm install
```
Настройте переменные окружения: Создайте файл .env в корневом каталоге и добавьте свои учетные данные Yahoo:
```
YAHOO_EMAIL=your-email@yahoo.com
YAHOO_CLIENT_ID=your-client-id
YAHOO_CLIENT_SECRET=your-client-secret
YAHOO_REDIRECT_URI=https://localhost/callback
```

Аутентификация

При первом запуске сервера будет запущен процесс OAuth2:

Откроется окно браузера с запросом на вход в Yahoo.
После авторизации вы будете перенаправлены на ваш REDIRECT_URI.
Страница может не загрузиться, но это нормально — скопируйте параметр code из адресной строки.
Вставьте код обратно в терминал.
Сервер обменяет код на токены и безопасно сохранит их в .tokens.json.

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

Разработка

Чтобы запустить сервер в режиме разработки с помощью vite-node:

npm run dev

Сборка

Чтобы собрать проект для продакшена:

npm run build

Интеграция с Claude Desktop

Чтобы использовать этот сервер с Claude Desktop, добавьте его в свой файл claude_desktop_config.json:

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

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

src/index.ts: точка входа для MCP-сервера.
src/server.ts: инициализация MCP-сервера и регистрация инструментов.
src/auth/: процесс OAuth2 и управление токенами.
src/tools/: реализация отдельных инструментов для работы с электронной почтой.
src/lib/: вспомогательные библиотеки для подключений IMAP и SMTP.

Лицензия

ISC

Yahoo Mail MCP Server