Cloudflare Email MCP & API Wrapper 📧

CloudflareのEmail Service経由でメールを送信するための、JSON APIおよび**Model Context Protocol (MCP)**サーバーを公開する、オープンソースで本番環境対応のCloudflare Workerです。

特徴

• MCPサーバー: AIエージェント（Claude、Geminiなど）に直接接続してメールを送信します。

• REST API: 従来のアプリケーション統合のためのシンプルなJSONエンドポイント。

• 高度なメールサポート: HTML本文、複数の宛先（To、CC、BCC）、および添付ファイルをサポート。

• エッジパフォーマンス: Cloudflare Workers上に構築されており、グローバルな低遅延を実現。

• 安全: APIおよびMCPエンドポイントの両方でBearerトークン認証を使用。

Related MCP server: communication-mcp-server

クイックスタート（一度デプロイ）

1. 前提条件

• Email Routing用に設定されたドメインを持つCloudflareアカウント。

• 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

🤖 AIエージェント統合 (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