email-mcp

IMAP + SMTP를 통한 단일 메일함용 소규모 개인 MCP 서버입니다.

주로 개인적인 설정에 맞춰져 있습니다:

메일함 1개
환경 변수를 통해 제공되는 자격 증명
IMAP을 통한 메일 읽기
SMTP를 통한 메일 보내기
Yandex Mail 기본 설정에서 잘 작동하지만, 모든 IMAP/SMTP 제공업체에 연결 가능

변경 사항

이 저장소는 원래 stdio 모드에서만 작동했습니다. 로컬 MCP 클라이언트에는 적합하지만, ChatGPT 웹 통합에는 HTTP MCP 엔드포인트가 필요합니다. 이제 서버는 다음을 지원합니다:

로컬/개발용 stdio
ChatGPT 웹 앱용 streamable-http
호환성을 위한 sse

또한 메일 스레딩 문제를 수정했습니다:

이전의 reply_to 매개변수는 Reply-To 헤더만 설정했습니다.
실제 답장에는 일반적으로 In-Reply-To 및 References를 사용해야 합니다.
read_email은 이제 해당 헤더를 반환하여 send_email에 다시 전달할 수 있도록 합니다.

또한 read_email 출력을 개선하여 다음을 반환합니다:

디코딩된 헤더
첨부 파일 메타데이터
메시지 스레딩 헤더

파일

server.py — MCP 도구 정의 및 전송 시작
mail_ops.py — IMAP/SMTP 구현
requirements.txt — Python 의존성

환경

필수:

export MAILBOX_EMAIL="you@example.com"
export MAILBOX_PASSWORD="your-app-password"

선택적 제공업체 설정:

export IMAP_HOST="imap.yandex.com"
export IMAP_PORT="993"
export SMTP_HOST="smtp.yandex.com"
export SMTP_PORT="465"

선택적 MCP 서버 설정:

export MCP_TRANSPORT="stdio"
export MCP_HOST="0.0.0.0"
export MCP_PORT="8000"

편의를 위해 별칭도 지원됩니다:

export YANDEX_EMAIL="you@yandex.ru"
export YANDEX_APP_PASSWORD="..."

설치

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

stdio로 로컬 실행

python server.py

이 모드는 프로세스를 직접 생성하는 로컬 MCP 클라이언트에 적합합니다.

ChatGPT 웹 앱용 실행

ChatGPT 웹에는 공개 HTTPS MCP 엔드포인트가 필요합니다. 서버를 HTTP 모드로 시작하세요:

python server.py --transport streamable-http --host 0.0.0.0 --port 8000

그런 다음 공개 HTTPS 터널이나 리버스 프록시를 통해 해당 포트를 노출하고, 결과로 생성된 MCP URL을 ChatGPT에 등록하세요.

노출된 도구

`list_folders()`

사용 가능한 IMAP 폴더를 나열합니다.

`search_emails(folder="INBOX", text=None, unseen_only=False, since_date=None, limit=30)`

IMAP 기준에 따라 메시지를 검색합니다.

다음과 같은 항목을 반환합니다:

uid
subject
from
to
date
flags
size_bytes

`read_email(uid, folder="INBOX")`

읽음 표시 없이 전체 메시지를 가져옵니다.

반환값:

디코딩된 헤더
message_id
in_reply_to
references
attachments
body_plain
body_html

`send_email(...)`

SMTP를 통해 메시지를 보냅니다.

중요 매개변수:

reply_to_header — Reply-To 헤더를 설정합니다.
in_reply_to — 스레딩 헤더
references — 스레딩 헤더

실제 답장을 보내려면 in_reply_to와 일반적으로 references를 사용하세요.

Yandex 참고 사항

일반적인 Yandex 기본 설정은 다음과 같습니다:

IMAP: SSL/TLS를 통한 imap.yandex.com:993
SMTP: SSL/TLS를 통한 smtp.yandex.com:465

주 계정 비밀번호가 아닌 앱 비밀번호를 사용하세요.

향후 합리적인 업그레이드

첨부 파일 다운로드 도구
확인 절차가 포함된 이동/보관/삭제 도구
환경 변수 기반 자격 증명 대신 OAuth 사용
모의 IMAP/SMTP 백엔드를 사용한 테스트

Email MCP Server