이메일 MCP 서버

“이메일” MCP 서버는 무엇을 하나요?

이메일 MCP 서버는 AI 어시스턴트가 SMTP를 통해 이메일을 발송하고 파일을 첨부할 수 있도록 해주는 간단한 Model Context Protocol(MCP) 서버입니다. AI 에이전트와 외부 이메일 시스템 사이의 브릿지 역할을 하며, 기본 및 고급 이메일 발송 기능(HTML 콘텐츠, 파일 첨부, 참조/숨은참조 지원, SMTP 연결 테스트 등)을 제공합니다. 개발자와 AI 에이전트가 커뮤니케이션 작업을 자동화하고, SMTP 설정을 검증하며, 이메일 설정을 프로그래밍 방식으로 관리할 수 있어 실제 메시징 시스템과의 상호작용 능력을 확장하고 개발/자동화 시나리오에서 생산성을 높일 수 있습니다.

프롬프트 목록

저장소에 명시적인 프롬프트 템플릿이 문서화되어 있지 않습니다. 이 섹션은 비어 있습니다.

리소스 목록

문서나 코드에 명시적인 MCP 리소스가 언급되어 있지 않습니다. 이 섹션은 비어 있습니다.

도구 목록

• send_email
  설정된 SMTP 정보를 사용하여 수신자에게 일반 텍스트 또는 HTML 이메일을 보내는 간단한 도구입니다. 수신자, 제목, 본문이 필요합니다.

• send_custom_email
  참조/숨은참조, 파일 첨부, HTML 포맷, 이메일별 SMTP 설정 재정의를 지원하는 고급 이메일 발송 도구입니다.

• test_smtp_connection_tool
  SMTP 구성을 검증하고 이메일 발송이 정상적으로 설정되었는지 사전에 확인할 수 있는 유틸리티 도구입니다.

MCP 서버의 활용 사례

• 자동 이메일 알림
  AI 에이전트가 사용자나 팀에게 즉각적인 알림, 리마인더, 상태 업데이트를 이메일로 발송하여 커뮤니케이션 워크플로우를 간소화할 수 있습니다.

• 파일 및 보고서 배포
  생성된 보고서, 로그, 문서 등을 첨부파일로 한 명 혹은 여러 명에게 배포하여 수동 공유 과정을 줄입니다.

• 포맷이 적용된 팀 공지
  HTML 지원을 활용해 시각적으로 돋보이는 팀 소식이나 뉴스레터를 참조/숨은참조로 여러 수신자에게 전송할 수 있습니다.

• SMTP 설정 검증
  개발자는 배포나 통합 전 SMTP 설정을 빠르게 점검하여, 이메일 발송 실패를 방지할 수 있습니다.

• 개인화된 아웃리치 자동화
  온보딩, 고객 지원, 팔로업 등 개인화된 이메일 발송을 자동화하여, AI를 통해 대규모 메시지를 작성하고 전달할 수 있습니다.

설정 방법

Windsurf

저장소에 Windsurf용 별도의 설정 안내가 없습니다.

Claude

1. 필요 소프트웨어 설치

   • uv(Python 패키지 매니저) 설치:
     curl -LsSf https://astral.sh/uv/install.sh | sh
     터미널을 재시작하거나 source ~/.bashrc 실행

2. 프로젝트 의존성 설치

   • cd email-mcp-server
   • uv sync

3. 설치 테스트

   • uv run python test_email.py
   • (선택) 서버 실행: uv run main.py

4. Claude Desktop 설정

   • Claude Desktop 설정 파일을 편집하여 다음을 추가:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

중요: 설치한 경로에 맞게 directory 경로를 수정하세요.

Cursor

1. 필요 소프트웨어 설치

   • uv 설치:
     curl -LsSf https://astral.sh/uv/install.sh | sh
     터미널을 재시작하거나 source ~/.bashrc 실행

2. 프로젝트 의존성 설치

   • cd email-mcp-server
   • uv sync

3. 설치 테스트

   • uv run python test_email.py
   • (선택) 서버 실행: uv run main.py

4. Cursor 설정

   • 설정 파일을 편집하여 다음을 추가:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

중요: 설치한 경로에 맞게 directory 경로를 수정하세요.

Cline

저장소에 Cline용 별도의 설정 안내가 없습니다.

환경 변수로 API 키 보호하기

MCP 서버 설정의 env 섹션을 통해 민감한 SMTP 자격 증명을 구성하세요. 예시:

"env": {
  "SMTP_HOST": "smtp.gmail.com",
  "SMTP_PORT": "587",
  "SMTP_SECURE": "false",
  "SMTP_USER": "your-email@gmail.com",
  "SMTP_FROM": "your-email@gmail.com",
  "SMTP_PASS": "your-app-password"
}

실제 비밀 값은 가능하다면 설정 파일 외부에 보관하세요.

플로우에서 MCP 사용 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, MCP 컴포넌트를 플로우에 추가하고 AI 에이전트에 연결하세요:

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 설정 섹션에서 다음과 같은 JSON 형태로 MCP 서버 정보를 입력하세요:

{
  "email-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면 AI 에이전트가 이 MCP를 도구로 활용할 수 있게 되며, 모든 기능과 역량에 접근할 수 있습니다. “email-mcp"를 실제 이름으로, URL도 환경에 맞게 변경하는 것을 잊지 마세요.

요약

Roots 지원: 언급 없음

샘플링 지원: 언급 없음

위 표에 따르면, 이메일 MCP 서버는 이메일 자동화를 위한 강력하고 명확한 도구를 제공하지만, 프롬프트 템플릿, 명시적 MCP 리소스, roots·샘플링 등 고급 프로토콜 기능에 대한 문서가 부족합니다. Claude와 Cursor용 설정은 간단하며 환경 변수 지원이 분명합니다.

의견

이 MCP 서버는 본연의 목적에는 간결하고 문서화가 잘 되어 있으나, 고급 MCP 기능 및 리소스가 부족합니다. 이메일 업무에는 매우 유용하나, 확장성과 프로토콜 깊이 측면에서는 한계가 있습니다. 기본적인 유틸리티와 문서화 기준으로 6/10으로 평가하며, 기능 완성도와 MCP 프로토콜 범위에서 개선 여지가 있습니다.

MCP 점수