MCP-сервер Yahoo Mail

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

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

• Чтение писем: получение последних сообщений из папки «Входящие».

• Поиск писем: поиск конкретных сообщений по ключевым словам, отправителям или датам.

• Отправка писем: создание и отправка электронных писем с использованием SMTP-серверов Yahoo.

Related MCP server: Gmail MCP Server

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

• Node.js: версия 20 или выше.

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

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

1. Перейдите на портал разработчиков Yahoo.

2. Создайте новое приложение.

3. Установите разрешения API (API Permissions), включив Mail (чтение и запись).

4. Установите URI перенаправления (Redirect URI) на https://localhost/callback (или предпочитаемый вами URI).

5. Запишите свои Client ID и Client Secret.

Настройка

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

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

2. Установите зависимости:

   npm install

3. Настройте переменные окружения: Создайте файл .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:

1. Откроется окно браузера с запросом на вход в Yahoo.

2. После авторизации вы будете перенаправлены на ваш REDIRECT_URI.

3. Страница может не загрузиться, но это нормально — скопируйте параметр code из адресной строки.

4. Вставьте код обратно в терминал.

5. Сервер обменяет код на токены и безопасно сохранит их в .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