MailDevMcp

English | 日本語

mcp 이름: io.github.pierre3/maildev-mcp

MailDev용 MCP(Model Context Protocol) 서버입니다.
AI 기반 편집기 또는 MCP 클라이언트에서 직접 MailDev Docker 컨테이너를 관리하고 수신된 이메일을 검사할 수 있습니다.

이 서버는 MCP 클라이언트가 다음 작업을 수행해야 하는 로컬 개발 및 테스트 자동화 시나리오를 대상으로 합니다:

• MailDev 컨테이너 시작 또는 중지

• 받은 편지함 내용 검사

• 애플리케이션 동작 트리거 후 이메일 대기

• HTML 본문 및 첨부 파일 검사

• 첨부 파일 무결성을 바이트 단위로 검증

설치

.NET 전역 도구로 설치합니다:

dotnet tool install -g MailDevMcp

설치가 완료되면 maildev-mcp 명령을 사용할 수 있습니다.

Related MCP server: @injaan.dev/ms365-email-cli-mcp

MCP 클라이언트 구성

MCP 클라이언트 설정(예: Claude Desktop, VS Code 등)에 다음을 추가합니다:

{
  "mcpServers": {
    "maildev-mcp": {
      "command": "maildev-mcp",
      "env": {
        "MAILDEV_API_PORT": "1080"
      }
    }
  }
}

환경 변수

일반적인 워크플로우

1. StartMaildev를 호출하여 로컬 MailDev 컨테이너 시작

2. 애플리케이션에서 이메일을 보내도록 트리거

3. 배송이 비동기인 경우 WaitForEmail 호출

4. ListEmails, SearchEmails 또는 GetEmail을 사용하여 결과 검사

5. 더 깊은 검증이 필요한 경우 GetEmailHtml, GetAttachmentContent 또는 VerifyAttachment 사용

6. DeleteEmail, DeleteAllEmails 또는 StopMaildev로 정리

사용 가능한 도구

도구 동작 참고 사항

• StartMaildev

  • 사용자 지정 SMTP 및 API 포트 지원

  • 선택적 SMTP 인증 지원

  • 비어 있거나 공백만 있는 자격 증명은 인증 비활성화로 처리

  • 생성된 자체 서명 인증서로 TLS 지원

• GetEmail 및 ListEmails

  • 누락되거나 비어 있는 제목을 (no subject)로 렌더링

  • 누락된 주소 목록을 (none)으로 렌더링

• WaitForEmail

  • 일치하는 이메일이 도착하거나 제한 시간에 도달할 때까지 MailDev를 폴링

  • 폴링 중 발생한 일시적인 MailDev 연결 실패를 반환 메시지에 보고

• VerifyAttachment

  • Base64로 인코딩된 원본 페이로드 수락

  • 수신된 첨부 파일을 바이트 단위로 비교

  • 정확히 일치, 크기 불일치 또는 콘텐츠 불일치를 보고

요구 사항 및 가정

• Docker가 설치되어 있고 이 MCP 서버가 실행되는 동일한 머신에서 사용 가능해야 함

• MailDev는 localhost의 HTTP API를 통해 접근됨

• MCP 클라이언트에 구성된 API 포트는 Docker가 노출하는 MailDev API 포트와 일치해야 함

사전 요구 사항

• .NET 10 SDK 이상

• Docker (MailDev 컨테이너 실행용)

소스에서 빌드

git clone https://github.com/pierre3/MailDevMcp.git
cd MailDevMcp
dotnet pack -c Release
dotnet tool install -g --add-source ./bin/Release MailDevMcp

라이선스

MIT