ai-mail-mcp

개인 도메인 이메일을 모든 MCP 클라이언트에 연결하는 이메일 서비스입니다. 발신(자동 서명/브랜드 소개 페이지 링크 추가), 수신, 본문 읽기, 연결 테스트를 지원합니다.

WorkBuddy, Claude Desktop, Cursor 등 MCP 프로토콜을 지원하는 모든 도구와 호환됩니다. 클라우드 배포를 통해 WorkBuddy 데스크톱 및 모바일에서 동일한 이메일 계정을 사용하여 언제 어디서나 자연어로 이메일 업무를 처리할 수 있습니다.

특징

• ✉️ send_email: 이메일 발신, 자동으로 "xx가 xx를 통해 자동 발송" 개인 서명 추가 (소개 페이지 링크 포함, 개인 IP 진입점으로 활용 가능)

• 📥 get_recent_emails: 최근 N일 이메일 목록 조회 (제목/발신자/시간)

• 📖 get_email_content: UID별 이메일 전체 본문 및 첨부파일 정보 읽기

• 🔌 test_email_connection: SMTP/IMAP 연결 한 번에 테스트

• 🚀 두 가지 전송 방식: stdio(로컬 디버깅) / SSE(클라우드 원격 배포)

• 🔐 엔드포인트 Bearer Token 인증, 모든 자격 증명은 환경 변수로 처리, 절대 하드코딩하지 않음

아키텍처

┌──────────────┐   HTTPS + Bearer   ┌──────────────────┐   SMTP/IMAP   ┌──────────────┐
│ WorkBuddy    │ ─────────────────▶ │ ai-mail-mcp      │ ────────────▶ │ 你的域名邮箱   │
│ 桌面端 / 移动端 │                   │ (云端 MCP Server) │               │ you@your.com │
└──────────────┘                   └──────────────────┘               └──────────────┘

클라우드 배포가 핵심입니다: 하나의 HTTPS 엔드포인트로 데스크톱과 모바일 모두 연결 가능하며, 로컬 기기를 켤 필요가 없습니다.

빠른 시작

1. 환경 변수 설정

cp .env.example .env
# 编辑 .env，填入你的邮箱账号、授权码、SMTP/IMAP 地址、Bearer Token

2A. 로컬 디버깅 (stdio)

npm install
MCP_TRANSPORT=stdio node server.js

2B. 클라우드 배포 (SSE, 권장)

공인 IP가 있는 서버 + 도메인(HTTPS)이 필요합니다.

cp .env.example .env   # 在服务器上填写真实配置
docker compose up -d

그런 다음 nginx 리버스 프록시 + acme.sh/certbot으로 HTTPS 인증서를 발급받아(docker-compose.yml에 주석 예제 포함), https://mcp.your-domain.com/mail-mcp/sse 형태의 엔드포인트를 얻습니다.

3. WorkBuddy에 연결 (사용자 정의 커넥터)

~/.workbuddy/mcp.json 편집:

{
  "mcpServers": {
    "ai-mail-mcp": {
      "type": "sse",
      "url": "https://mcp.your-domain.com/mail-mcp/sse",
      "headers": {
        "Authorization": "Bearer 你的随机Token"
      }
    }
  }
}

WorkBuddy 커넥터 관리 페이지에서 해당 커넥터를 Trust/활성화하고 세션을 다시 시작하면 대화에서 다음을 사용할 수 있습니다:

• "xx에게 제목..., 내용...으로 이메일 보내줘"

• "최근 3일 이메일 보여주고, 답장 필요한 것들 정리해줘"

• "매일 아침 9시에 어제 이메일 요약을 내 메일로 보내줘"

도구 목록

보안 팁

• MCP_BEARER_TOKEN은 충분히 무작위적인 긴 문자열(openssl rand -hex 32로 생성)로 설정하고 안전하게 보관하세요.

• .env 및 실제 자격 증명은 절대 저장소에 커밋하지 마세요; 이 문서 저장소는 .env.example만 커밋합니다.

• 이메일은 독립 계정 + 최소 권한(수신/발신만, 삭제/관리 권한 없음)을 사용하는 것이 좋습니다.

• 자체 호스팅은 이메일 데이터가 전적으로 자체 서버에 있으며 제3자에게 전달되지 않음을 의미합니다.

License

MIT