Cloudflare Email MCP & API Wrapper 📧

Un Cloudflare Worker de código abierto y listo para producción que expone una API JSON y un servidor de Protocolo de Contexto de Modelo (MCP) para enviar correos electrónicos a través del servicio de correo electrónico de Cloudflare.

Características

• Servidor MCP: Conéctese directamente a agentes de IA (Claude, Gemini, etc.) para enviar correos electrónicos.

• API REST: Punto final JSON simple para la integración de aplicaciones tradicionales.

• Soporte avanzado de correo electrónico: Cuerpos HTML, múltiples destinatarios (Para, CC, CCO) y archivos adjuntos.

• Rendimiento en el borde (Edge): Construido sobre Cloudflare Workers para una baja latencia global.

• Seguro: Autenticación mediante token Bearer tanto para la API como para los puntos finales MCP.

Related MCP server: communication-mcp-server

Inicio rápido (Desplegar una vez)

1. Requisitos previos

• Una cuenta de Cloudflare con un dominio configurado para Email Routing.

• bun o npm instalados.

2. Instalación

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

3. Configuración

Copie .dev.vars.example a .dev.vars y rellene sus valores locales:

• API_TOKEN: Un token seguro para la autenticación del punto final.

• DEFAULT_SENDER: Una dirección de correo electrónico autorizada de su dominio de Email Routing.

• DEFAULT_FROM_NAME: Nombre para mostrar del remitente opcional.

4. Despliegue

bun run deploy

🤖 Integración de agentes de IA (MCP)

Añadir a Claude Desktop

Añada lo siguiente a su claude_desktop_config.json:

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

Añadir a Gemini / Antigravity

Añada a su mcp_config.json:

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

🛠️ Referencia de la API

Enviar correo electrónico

POST /api/send

Cabeceras:

• Authorization: Bearer YOUR_API_TOKEN

• Content-Type: application/json

Cuerpo:

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

Licencia

MIT