Cloudflare Email MCP & API Wrapper 📧

Ein Open-Source, produktionsreifer Cloudflare Worker, der eine JSON-API und einen Model Context Protocol (MCP)-Server zum Senden von E-Mails über den Cloudflare Email Service bereitstellt.

Funktionen

• MCP-Server: Direkte Verbindung zu KI-Agenten (Claude, Gemini usw.), um E-Mails zu versenden.

• REST-API: Einfacher JSON-Endpunkt für die Integration in herkömmliche Anwendungen.

• Erweiterte E-Mail-Unterstützung: HTML-Inhalte, mehrere Empfänger (An, CC, BCC) und Anhänge.

• Edge-Performance: Basiert auf Cloudflare Workers für globale niedrige Latenz.

• Sicher: Bearer-Token-Authentifizierung für API- und MCP-Endpunkte.

Related MCP server: communication-mcp-server

Schnellstart (Einmalige Bereitstellung)

1. Voraussetzungen

• Ein Cloudflare-Konto mit einer für Email Routing konfigurierten Domain.

• bun oder npm installiert.

2. Installation

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

3. Konfiguration

Kopieren Sie .dev.vars.example nach .dev.vars und tragen Sie Ihre lokalen Werte ein:

• API_TOKEN: Ein sicheres Token für die Endpunkt-Authentifizierung.

• DEFAULT_SENDER: Eine autorisierte E-Mail-Adresse Ihrer Email-Routing-Domain.

• DEFAULT_FROM_NAME: Optionaler Anzeigename des Absenders.

4. Bereitstellung

bun run deploy

🤖 KI-Agenten-Integration (MCP)

Hinzufügen zu Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

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

Hinzufügen zu Gemini / Antigravity

Fügen Sie dies zu Ihrer mcp_config.json hinzu:

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

🛠️ API-Referenz

E-Mail senden

POST /api/send

Header:

• Authorization: Bearer YOUR_API_TOKEN

• Content-Type: application/json

Body:

{
  "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"
    }
  ]
}

Lizenz

MIT