Mailgun MCP 서버

개요

Mailgun을 위한 모델 컨텍스트 프로토콜(MCP) 서버로, AI 에이전트가 이메일 발송, 전달 가능성 진단, 계정 운영 관리를 수행할 수 있는 실용적이고 워크플로우 중심적인 인터페이스를 제공합니다.

참고: 이 MCP 서버는 사용자의 로컬 머신에서 실행됩니다. Mailgun은 현재 이 서버의 호스팅 버전을 제공하지 않습니다.

기능

• 메시징 — 이메일 발송, 저장된 메시지 검색, 메시지 재발송

• 도메인 — 도메인 세부 정보 확인, DNS 구성 검증, 추적 설정(클릭, 열람, 수신 거부) 관리

• 웹훅 — 이벤트 웹훅 목록 조회, 생성, 업데이트 및 삭제

• 라우팅 — 인바운드 이메일 라우팅 규칙 조회 및 업데이트

• 메일링 리스트 — 메일링 리스트 및 멤버 생성 및 관리

• 템플릿 — 버전 관리가 포함된 이메일 템플릿 생성 및 관리

• 분석 — 발송 지표, 사용량 지표 및 로그 쿼리

• 통계 — 도메인, 태그, 제공업체, 기기 및 국가별 집계 통계 조회

• 수신 거부(Suppressions) — 반송(Bounce), 수신 거부, 불만 제기 및 허용 목록 항목 조회

• IP 및 IP 풀 — IP 할당 및 전용 IP 풀 구성 조회

• 반송 분류 — 반송 유형 및 전달 문제 분석

Related MCP server: Enhanced Gmail MCP Server

사전 요구 사항

• Node.js (v20.12 이상)

• Mailgun 계정 및 API 키

빠른 시작

구성

MCP 클라이언트 구성에 다음을 추가하세요:

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key",
        "MAILGUN_API_REGION": "us"
      }
    }
  }
}

환경 변수

클라이언트별 구성 경로

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

• Claude Desktop (Windows): %APPDATA%/Claude/claude_desktop_config.json

• Claude Code: claude mcp add 실행 또는 ~/.claude.json 편집

샘플 프롬프트

이메일 보내기

Can you send an email to EMAIL_HERE with a funny email body that makes it sound
like it's from the IT Desk from Office Space? Please use the sending domain
DOMAIN_HERE, and make the email from "postmaster@DOMAIN_HERE"!

참고: 일부 MCP 클라이언트는 데이터를 전송하는 도구를 호출하기 위해 유료 플랜이 필요할 수 있습니다. 발송이 조용히 실패하면 클라이언트의 플랜을 확인하세요.

발송 통계 가져오기 및 시각화

Would you be able to make a chart with email delivery statistics for the past week?

템플릿 관리

Create a welcome email template for new signups on my domain DOMAIN_HERE.
Include a personalized greeting and a call-to-action button.

전달 가능성 조사

Can you check the bounce classification stats for my account and tell me
what the most common bounce reasons are?

DNS 문제 해결

Check the DNS verification status for my domain DOMAIN_HERE and tell me
if anything needs fixing.

수신 거부 검토

Are there any unsubscribes or complaints for DOMAIN_HERE? Summarize the
top offenders.

라우팅 규칙 관리

List all my inbound routes and explain what each one does.

메일링 리스트 생성

Create a mailing list called announcements@DOMAIN_HERE and add these
members: alice@example.com, bob@example.com.

도메인 비교

Compare my sending volume and delivery rates across all my domains for
the past month.

지역별 참여도

Break down my email engagement by country and device for DOMAIN_HERE.

추적 설정 검토

List all my domains and show which ones have tracking enabled for clicks
and opens.

개발

소스에서 실행하려면 저장소를 복제하고 node를 직접 사용하세요:

git clone https://github.com/mailgun/mailgun-mcp-server.git
cd mailgun-mcp-server
npm install
npm test

MCP 클라이언트 구성에서 npx 명령을 다음으로 교체하세요:

"command": "node",
"args": ["/path/to/mailgun-mcp-server/src/mailgun-mcp.js"]

보안 고려 사항

API 키 격리

Mailgun API 키는 환경 변수로 전달되며 AI 모델 자체에는 노출되지 않습니다. 이는 MCP 서버 프로세스가 요청을 인증하는 데만 사용됩니다. 서버는 API 키, 요청 매개변수 또는 응답 데이터를 기록하지 않습니다.

로컬 실행

서버는 사용자의 로컬 머신에서 실행됩니다. Mailgun API와의 모든 통신은 TLS 인증서 검증이 적용된 HTTPS를 통해 이루어집니다. Mailgun API 외의 타사 서비스로 데이터가 전송되지 않습니다.

API 키 권한

필요한 작업에만 범위가 지정된 권한을 가진 전용 Mailgun API 키를 사용하세요. 서버는 읽기 및 업데이트 작업을 노출하지만 삭제 작업은 노출하지 않으므로 의도치 않은 작업의 피해 범위를 제한합니다.

속도 제한

서버는 클라이언트 측 속도 제한을 구현하지 않습니다. AI의 각 도구 호출은 Mailgun API 요청으로 직접 변환됩니다. 서버는 남용을 방지하기 위해 Mailgun의 서버 측 속도 제한에 의존하며, 해당 제한을 초과하는 요청은 AI 어시스턴트에게 오류를 반환합니다.

프롬프트 인젝션

다른 MCP 서버와 마찬가지로, 조작되거나 악의적인 프롬프트는 AI 어시스턴트가 의도하지 않은 작업(예: 추적 설정 수정 또는 메일링 리스트 멤버 읽기)을 수행하도록 유도할 수 있습니다. 특히 신뢰할 수 없는 프롬프트 컨텍스트에서는 작업을 승인하기 전에 AI 어시스턴트의 도구 호출 확인 내용을 검토하세요.

웹훅 URL

웹훅 생성 및 업데이트 작업은 AI 어시스턴트를 통해 제공되는 임의의 URL을 허용합니다. MCP 서버는 추가 검증 없이 이러한 URL을 Mailgun API로 전달합니다. 웹훅 대상 검증은 Mailgun의 책임입니다. AI 어시스턴트가 의도치 않은 내부 또는 민감한 주소로 웹훅 URL을 설정하지 않도록 주의하세요.

입력 검증

모든 도구 매개변수는 Zod 스키마를 사용하여 Mailgun OpenAPI 사양에 따라 검증됩니다. 그러나 검증은 OpenAPI 사양의 정확성에 의존하며, 일부 예외적인 매개변수는 허용적인 검증으로 대체될 수 있습니다. Mailgun API는 추가적인 보호 계층으로 자체적인 서버 측 검증을 수행합니다.

디버깅

MCP 서버는 stdio를 통해 통신합니다. 문제 해결은 MCP 디버깅 가이드를 참조하세요.

라이선스

Apache 2.0 — 자세한 내용은 LICENSE를 참조하세요.

기여

기여를 환영합니다! Pull Request를 제출하거나 Issue를 열어주세요.