inbound-email-mcp

개요

inbound-email-mcp는 Channel.io 백엔드 시스템의 이메일 관련 데이터를 조회하기 위한 Model Context Protocol (MCP) 서버입니다. 이 도구를 사용하여 UserChat의 마지막 수신 이메일 데이터와 관련 첨부 파일을 조회할 수 있습니다. 주로 AWS DynamoDB와 S3에서 데이터를 가져와 제공합니다.

사용 방법

1. inbound-email-mcp 빌드

   cd apps/inbound-email-mcp && pnpm install && pnpm build

2. Cursor MCP 서버 추가

   Cursor Settings > Features > MCP 에서 "+ Add New MCP Server"를 클릭하여 MCP 서버를 추가합니다. (참고 문서)

   • Name: inbound-email-mcp (또는 원하는 이름)
   • Type: command
   • Command: npx
   • Args: (아래 두 줄을 각각 추가)
     • -y
     • @channel.io/inbound-email-mcp
   • Env: (필요한 환경 변수를 Key-Value 형태로 추가)
     • AWS_PROFILE: <<aws sso config를 통해 설정한 AWS PROFILE 이름>>

3. AI 어시스턴트와 상호작용

   채팅 인터페이스에서 AI 어시스턴트에게 조회하려는 UserChat ID를 제공하여 관련 이메일 데이터를 요청합니다.

   예시 프롬프트:

   UserChat ID 'xxxxxxxx'의 inbound email과 관련 데이터를 조회해줘.

주요 기능 및 특징

• UserChat ID를 기반으로 DynamoDB에서 UserChat 데이터 조회
• UserChat의 lastInboundEmailId를 사용하여 관련 이메일 데이터 조회
• S3 버킷(ch-ses-mail)에서 원본 이메일 MIME 데이터 조회
• AWS 서비스와의 안전한 통합을 통한 데이터 접근

기술 스택

• TypeScript
• AWS SDK (@aws-sdk/client-dynamodb, @aws-sdk/client-s3, @aws-sdk/util-dynamodb)
• Model Context Protocol (@modelcontextprotocol/sdk)