클로드포스트

Claude를 통해 원활한 이메일 관리 인터페이스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 통합을 통해 Claude와의 자연어 대화를 통해 이메일을 직접 처리할 수 있으며, 검색, 읽기, 안전한 이메일 전송 등의 기능을 지원합니다.

기능 및 데모

이메일 검색 및 읽기

• 📧 날짜 범위 및 키워드로 이메일 검색

• 📅 일일 이메일 통계 보기

• 📝 스레딩 지원을 통해 전체 이메일 내용을 읽어보세요

이메일 작성 및 발송

• ✉️ CC 수신자 지원을 포함한 이메일 보내기

• 🔒 TLS를 통한 안전한 이메일 처리

Related MCP server: Enhanced Gmail MCP Server

필수 조건

• Python 3.12 이상

• Gmail 계정(또는 다른 이메일 제공자)

• Gmail을 사용하는 경우:

  • 2단계 인증이 활성화되었습니다

  • 앱별 비밀번호 생성됨

• 클로드 데스크톱 애플리케이션

설정

1. uv 설치:

   지엑스피1

2. 프로젝트를 복제하고 설정합니다.

   # Clone the repository git clone https://github.com/ZilongXue/claude-post.git cd claude-post # Create and activate virtual environment uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies uv pip install -e .

3. 프로젝트 루트에 .env 파일을 만듭니다.

   EMAIL_ADDRESS=your.email@gmail.com EMAIL_PASSWORD=your-app-specific-password IMAP_SERVER=imap.gmail.com SMTP_SERVER=smtp.gmail.com SMTP_PORT=587

4. Claude Desktop 구성:

   먼저 Claude for Desktop이 설치되어 있는지 확인하세요. 최신 버전은 여기에서 설치할 수 있습니다. 이미 Claude for Desktop이 설치되어 있다면 최신 버전으로 업데이트하세요.

   Claude Desktop 구성 파일을 엽니다.

   # MacOS ~/Library/Application Support/Claude/claude_desktop_config.json # Create the file if it doesn't exist mkdir -p ~/Library/Application\ Support/Claude touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

   다음 구성을 추가합니다.

   { "mcpServers": { "email": { "command": "/Users/username/.local/bin/uv", "args": [ "--directory", "/path/to/claude-post/src/email_client", "run", "email-client" ] } } }

   /Users/username 과 /path/to/claude-post 실제 경로로 바꾸세요.

   구성을 업데이트한 후 Claude Desktop을 다시 시작하여 변경 사항을 적용하세요.

서버 실행

서버는 Claude Desktop을 통해 자동으로 실행됩니다.

• Claude가 올바르게 구성된 경우 서버가 시작됩니다.

• 수동 서버 관리가 필요 없습니다

• Claude가 닫히면 서버가 중지됩니다.

클로드를 통한 사용

자연어 명령을 사용하여 이메일과 상호 작용할 수 있습니다. 몇 가지 예를 들면 다음과 같습니다.

이메일 검색

• "지난주 이메일을 보여주세요"

• "제목에 '회의'가 포함된 이메일 찾기"

• "2024년 1월 1일부터 2024년 1월 7일까지 recruiting@linkedin.com 에서 보낸 이메일을 검색하세요"

• "지난 달에 보낸 이메일 검색"

이메일 내용 읽기

• "12345번 이메일 내용을 보여주세요"

• "HR에서 보낸 마지막 이메일의 전체 내용은 무엇입니까?"

이메일 통계

• "오늘 몇 개의 이메일을 받았나요?"

• "지난주 일일 이메일 수를 보여주세요"

이메일 보내기

• " john@example.com 으로 이메일을 보내고 싶습니다."

• " team@company.com 으로 회의 확인서 보내기"

참고: 보안상의 이유로, 클로드는 실제로 이메일을 보내기 전에 항상 이메일 세부 정보를 표시하여 확인을 요청합니다.

프로젝트 구조

보안 참고 사항

• 기본 계정 비밀번호 대신 앱별 비밀번호를 사용하세요.

• Gmail 사용자의 경우:

  1. Google 계정에서 2단계 인증을 활성화하세요

  2. 이 애플리케이션에 대한 앱 비밀번호를 생성하세요

  3. .env 파일에서 앱 비밀번호를 사용하세요

벌채 반출

애플리케이션은 자세한 정보를 email_client.log 에 기록합니다. 이 파일에서 디버깅 정보와 오류 메시지를 확인하세요.

특허

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