protonmail-mcp

Protonmail MCP 서버

이 MCP 서버는 Protonmail의 SMTP 서비스를 이용하여 이메일 전송 기능을 제공합니다. Claude Desktop과 Cline VSCode 확장 프로그램 모두 Protonmail 자격 증명을 사용하여 사용자를 대신하여 이메일을 전송할 수 있습니다.

호환성

이 MCP 서버는 다음과 호환됩니다.

• Claude 데스크톱 앱 : Claude용 독립형 데스크톱 애플리케이션
• Cline VSCode 확장 프로그램 : Visual Studio Code용 Claude 확장 프로그램

두 플랫폼 모두 MCP(Model Context Protocol) 표준을 사용하므로 동일한 구현이 두 플랫폼에서 모두 작동합니다.

특징

• 한 명 또는 여러 명의 수신자에게 이메일을 보냅니다.
• CC 및 BCC 수신자 지원
• 일반 텍스트와 HTML 이메일 콘텐츠 모두 지원
• 포괄적인 오류 처리 및 로깅

구성

서버에서는 Claude Desktop과 Cline 모두에 대해 MCP 설정 파일에 다음 환경 변수를 설정해야 합니다.

클로드 데스크톱 구성

위치: /Users/your-username/Library/Application Support/Claude/claude_desktop_config.json

Cline VSCode 확장 구성

위치: /Users/your-username/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

두 구성 파일 모두 다음과 같은 환경 변수가 필요합니다.

• PROTONMAIL_USERNAME : Protonmail 이메일 주소
• PROTONMAIL_PASSWORD : Protonmail SMTP 비밀번호(일반 로그인 비밀번호 아님)
• PROTONMAIL_HOST : SMTP 서버 호스트 이름(기본값: smtp.protonmail.ch)
• PROTONMAIL_PORT : SMTP 서버 포트(기본값: STARTTLS의 경우 587, SSL/TLS의 경우 465)
• PROTONMAIL_SECURE : 보안 연결을 사용할지 여부(기본값: 포트 587의 경우 "false", 포트 465의 경우 "true")
• DEBUG : 디버그 로깅을 활성화합니다(자세한 로그를 보려면 "true"로 설정하고, 숨기려면 "false"로 설정).

Protonmail의 SMTP 서비스에 대한 자세한 내용, SMTP 비밀번호를 얻는 방법 등을 알아보려면 공식 Protonmail SMTP 문서 를 참조하세요.

용법

구성이 완료되면 다음 도구를 사용하여 MCP 서버를 통해 이메일을 보낼 수 있습니다.

이메일 보내기

Protonmail SMTP 계정을 사용하여 이메일을 보냅니다.

매개변수:

• to : 수신자 이메일 주소. 여러 주소를 쉼표로 구분할 수 있습니다.
• subject : 이메일 제목줄
• body : 이메일 본문 내용(일반 텍스트 또는 HTML 가능)
• isHtml : (선택 사항) 본문에 HTML 콘텐츠가 포함되어 있는지 여부(기본값: false)
• cc : (선택 사항) 쉼표로 구분된 CC 수신자
• bcc : (선택 사항) 쉼표로 구분된 BCC 수신자

예:

지엑스피1

문제 해결

MCP 서버에 문제가 발생하면 다음을 확인하세요.

1. 두 구성 파일 모두에서 Protonmail SMTP 자격 증명이 올바른지 확인하세요.
2. 방화벽이 SMTP 포트를 차단하지 않았는지 확인하세요.
3. Protonmail 계정에 발송 제한이 있는지 확인하세요.
4. 로그에서 오류 메시지를 찾아보세요.
   • Claude 데스크톱 앱 로그
   • Cline VSCode 확장 출력 패널
5. 구성 변경 후 Claude Desktop 앱을 다시 시작하거나 VSCode 창을 다시 로드합니다.

개발

프로젝트를 빌드하려면:

서버를 수정하려면 src 디렉토리에 있는 파일을 편집하고 프로젝트를 다시 빌드하세요.

설치

이 MCP 서버는 Claude Desktop과 Cline VSCode 확장 프로그램 모두에 설치할 수 있습니다. 환경에 추가하는 방법은 다음과 같습니다.

수동 설치

1. 이 저장소를 로컬 컴퓨터에 복제하세요.
   git clone https://github.com/your-username/protonmail-mcp.git cd protonmail-mcp
2. 종속성을 설치하고 프로젝트를 빌드합니다.
   npm install npm run build
3. MCP 설정 파일에 서버 구성을 추가합니다(위의 구성 섹션 참조)

Cline을 사용하여 GitHub에서 설치하기

Cline은 GitHub 저장소에서 MCP 서버를 자동으로 복제하고 빌드할 수 있습니다. 이 기능을 사용하려면 다음 단계를 따르세요.

1. Cline에게 GitHub 저장소 URL을 제공하세요.
2. Cline이 서버를 복제하고 빌드하도록 하세요.
3. 필요한 구성 정보(SMTP 자격 증명 등)를 제공하세요.

Cline을 사용하여 GitHub에서 MCP 서버를 설치하는 방법에 대한 자세한 지침은 Cline MCP 서버 설치 문서를 참조하세요.

자원

• Protonmail SMTP 문서 - Protonmail의 SMTP 서비스 사용을 위한 공식 가이드
• Nodemailer 문서 - 이 MCP 서버에서 사용하는 이메일 전송 라이브러리
• 모델 컨텍스트 프로토콜 문서 - MCP 프로토콜에 대한 문서
• Claude Desktop 앱 - Claude Desktop 애플리케이션을 다운로드하세요
• Cline VSCode 확장 프로그램 - VSCode용 Cline 확장 프로그램 설치
• Cline MCP 문서 - MCP 서버에 대한 Cline 문서
• GitHub에서 MCP 서버 설치 - GitHub 저장소에서 MCP 서버를 설치하기 위한 가이드

더 많은 MCP 서버 찾기

다음 저장소와 디렉토리에서 추가 MCP 서버를 찾을 수 있습니다.

• 공식 MCP 서버 저장소 - 공식 MCP 서버 모음
• Awesome-MCP 서버 저장소 - 커뮤니티에서 큐레이팅한 MCP 서버 목록
• mcpservers.org - MCP 서버 온라인 디렉토리
• mcp.so - MCP 서버를 검색하기 위한 또 다른 디렉토리

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.