IMAP MCP 서버

AI 도우미가 상호작용을 통해 이메일을 확인하고, 메시지를 처리하고, 사용자 선호도를 학습할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

개요

이 프로젝트에서는 IMAP 이메일 서버와 인터페이스하여 다음과 같은 기능을 제공하는 MCP 서버를 구현합니다.

이메일 탐색 및 검색
이메일 정리(이동, 태그 지정, 표시)
이메일 작성 및 답변
대화형 이메일 처리 및 사용자 선호도 학습
자동화된 이메일 요약 및 분류
여러 IMAP 공급자 지원

IMAP MCP 서버는 Claude나 다른 MCP 호환 도우미와 함께 작동하도록 설계되어 시간이 지남에 따라 사용자의 선호도를 학습하는 지능형 이메일 도우미 역할을 할 수 있습니다.

특징

이메일 인증 : 다양한 인증 방법을 통해 IMAP 서버에 안전하게 액세스
이메일 검색 : 필터링 옵션을 사용하여 폴더 및 메시지 나열
이메일 내용 : 텍스트, HTML, 첨부 파일을 포함한 메시지 내용을 읽습니다.
이메일 작업 : 메시지 이동, 삭제, 읽음/읽지 않음으로 표시, 플래그 지정
이메일 작성 : 적절한 형식으로 메시지에 대한 답장을 초안하고 저장합니다.
- 일반 텍스트 및 HTML 응답 지원
- CC 지원을 통한 모두에게 답장 기능
- In-Reply-To 및 참조 헤더를 사용한 적절한 스레딩
- 적절한 폴더에 초안을 저장합니다.
검색 : 폴더 전체에 걸친 기본 검색 기능
상호작용 패턴 : 이메일 처리 및 학습 선호도를 위한 구조화된 패턴(계획됨)
학습 계층 : 사용자 결정을 기록하고 분석하여 미래 작업(계획)을 예측합니다.

현재 프로젝트 구조

이 프로젝트는 현재 다음과 같이 구성되어 있습니다.

지엑스피1

시작하기

필수 조건

Python 3.8 이상
IMAP 지원 이메일 계정(Gmail 권장)
패키지 관리 및 Python 스크립트 실행을 위한 uv

설치

아직 uv를 설치하지 않았다면 설치하세요:
curl -LsSf https://astral.sh/uv/install.sh | sh
패키지를 복제하고 설치합니다.
git clone https://github.com/non-dirty/imap-mcp.git cd imap-mcp uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e ".[dev]"

Gmail 구성

구성 파일을 만듭니다.
cp config.sample.yaml config.yaml
Gmail OAuth2 자격 증명을 설정하세요.
- Google Cloud Console 로 이동
- 새 프로젝트를 생성하거나 기존 프로젝트를 선택하세요
- Gmail API 활성화
- OAuth2 자격 증명 만들기(데스크톱 애플리케이션 유형)
- 클라이언트 구성 다운로드
Gmail 설정으로 config.yaml 업데이트하세요.
imap: host: imap.gmail.com port: 993 username: your-email@gmail.com use_ssl: true oauth2: client_id: YOUR_CLIENT_ID client_secret: YOUR_CLIENT_SECRET refresh_token: YOUR_REFRESH_TOKEN

용법

이메일 확인

받은 편지함에 이메일을 나열하려면:

uv run list_inbox.py --config config.yaml --folder INBOX --limit 10

사용 가능한 옵션:

--folder : 검사할 폴더를 지정합니다(기본값: INBOX)
--limit : 표시할 이메일의 최대 개수(기본값: 10)
--verbose : 자세한 로깅 출력을 활성화합니다.

MCP 서버 시작

IMAP MCP 서버를 시작하려면:

uv run imap_mcp.server --config config.yaml

디버깅이 가능한 개발 모드의 경우:

uv run imap_mcp.server --dev

OAuth2 토큰 관리

OAuth2 토큰을 새로 고치려면:

uv run imap_mcp.auth_setup refresh-token --config config.yaml

새로운 OAuth2 토큰을 생성하려면:

uv run imap_mcp.auth_setup generate-token --config config.yaml

개발

개발 환경 설정

# Set up virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

테스트 실행

pytest

보안 고려 사항

이 MCP 서버는 민감한 개인 정보가 포함된 이메일 계정에 접근해야 합니다. 다음 보안 고려 사항을 숙지해 주십시오.

환경 변수 또는 보안 자격 증명 저장소를 사용하여 이메일 자격 증명을 안전하게 저장합니다.
기본 계정 비밀번호 대신 앱별 비밀번호를 사용하는 것을 고려하세요.
사용 사례에 필요한 것만으로 폴더 액세스를 제한하세요.
이메일 제공자 설정에서 서버에 부여된 권한을 검토하세요.

프로젝트 로드맵

[x] 프로젝트 초기화 및 저장소 설정
[x] 기본 IMAP 통합
[x] 이메일 리소스 구현
[x] 이메일 도구 구현
[x] 이메일 답장 및 초안 기능
[ ] 사용자 선호도 학습 구현
[ ] 고급 검색 기능
[ ] 다중 계정 지원
[ ] 주요 이메일 제공업체와의 통합

기여하다

기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.

특허

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

감사의 말

프레임워크를 제공하기 위한 모델 컨텍스트 프로토콜
클로드를 개발하기 위한 인류학적
이 프로젝트를 가능하게 하는 다양한 Python IMAP 라이브러리

IMAP MCP Server

Integrations