Cloudflare 이메일 MCP & API 래퍼 📧

Cloudflare의 이메일 서비스를 통해 이메일을 보내기 위한 JSON API 및 MCP(Model Context Protocol) 서버를 노출하는 오픈 소스 프로덕션 준비 완료 Cloudflare Worker입니다.

주요 기능

• MCP 서버: AI 에이전트(Claude, Gemini 등)에 직접 연결하여 이메일을 전송합니다.

• REST API: 기존 애플리케이션 통합을 위한 간단한 JSON 엔드포인트입니다.

• 고급 이메일 지원: HTML 본문, 다중 수신자(받는 사람, 참조, 숨은 참조) 및 첨부 파일을 지원합니다.

• 엣지 성능: 전 세계적으로 낮은 지연 시간을 위해 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: 이메일 라우팅 도메인에서 승인된 이메일 주소.

• 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