Cloudflare Email MCP & API Wrapper 📧

Open-source Cloudflare Worker, готовый к промышленному использованию, который предоставляет JSON API и сервер Model Context Protocol (MCP) для отправки электронных писем через сервис Cloudflare Email.

Возможности

• MCP-сервер: прямое подключение к ИИ-агентам (Claude, Gemini и др.) для отправки писем.

• REST API: простой JSON-эндпоинт для интеграции с традиционными приложениями.

• Расширенная поддержка почты: HTML-тела писем, несколько получателей (To, CC, BCC) и вложения.

• Производительность на границе сети: построено на базе Cloudflare Workers для обеспечения низкой задержки по всему миру.

• Безопасность: аутентификация через Bearer-токен как для API, так и для MCP-эндпоинтов.

Related MCP server: communication-mcp-server

Быстрый старт (развертывание)

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

• Аккаунт Cloudflare с доменом, настроенным для Email Routing.

• Установленный bun или npm.

2. Установка

git clone https://github.com/sh20raj/cf-email-mcp-api.git
cd cf-email-mcp-api
bun install

3. Конфигурация

Скопируйте .dev.vars.example в .dev.vars и заполните локальные значения:

• API_TOKEN: безопасный токен для аутентификации эндпоинта.

• DEFAULT_SENDER: авторизованный адрес электронной почты из вашего домена Email Routing.

• DEFAULT_FROM_NAME: необязательное отображаемое имя отправителя.

4. Развертывание

bun run deploy

🤖 Интеграция с ИИ-агентами (MCP)

Добавление в Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "cf-email": {
      "transport": "http",
      "url": "https://your-worker.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Добавление в Gemini / Antigravity

Добавьте в ваш mcp_config.json:

{
  "mcpServers": {
    "cf-email": {
      "transport": "http",
      "url": "https://your-worker.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

🛠️ Справочник API

Отправка письма

POST /api/send

Заголовки:

• Authorization: Bearer YOUR_API_TOKEN

• Content-Type: application/json

Тело запроса:

{
  "to": "recipient@example.com",
  "replyTo": "support@example.com",
  "subject": "Hello from API",
  "html": "<h1>Professional Email</h1><p>Sent via Cloudflare Workers.</p>",
  "attachments": [
    {
      "name": "report.pdf",
      "type": "application/pdf",
      "data": "BASE64_ENCODED_DATA"
    }
  ]
}

Лицензия

MIT