IMAP MCP 서버

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

개요

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

• 이메일 탐색 및 검색

• 이메일 정리(이동, 태그 지정, 표시)

• 이메일 작성 및 답변

• 대화형 이메일 처리 및 사용자 선호도 학습

• 자동화된 이메일 요약 및 분류

• 여러 IMAP 공급자 지원

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

Related MCP server: Gmail MCP Server

특징

• 이메일 인증 : 다양한 인증 방법을 통해 IMAP 서버에 안전하게 액세스

• 이메일 검색 : 필터링 옵션을 사용하여 폴더 및 메시지 나열

• 이메일 내용 : 텍스트, HTML, 첨부 파일을 포함한 메시지 내용을 읽습니다.

• 이메일 작업 : 메시지 이동, 삭제, 읽음/읽지 않음으로 표시, 플래그 지정

• 이메일 작성 : 적절한 형식으로 메시지에 대한 답장을 초안하고 저장합니다.

  • 일반 텍스트 및 HTML 응답 지원

  • CC 지원을 통한 모두에게 답장 기능

  • In-Reply-To 및 참조 헤더를 사용한 적절한 스레딩

  • 적절한 폴더에 초안을 저장합니다.

• 검색 : 폴더 전체에 걸친 기본 검색 기능

• 상호작용 패턴 : 이메일 처리 및 학습 선호도를 위한 구조화된 패턴(계획됨)

• 학습 계층 : 사용자 결정을 기록하고 분석하여 미래 작업(계획)을 예측합니다.

현재 프로젝트 구조

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

지엑스피1

시작하기

필수 조건

• Python 3.8 이상

• IMAP 지원 이메일 계정(Gmail 권장)

• 패키지 관리 및 Python 스크립트 실행을 위한 uv

설치

1. 아직 uv를 설치하지 않았다면 설치하세요:

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. 패키지를 복제하고 설치합니다.

   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 구성

1. 구성 파일을 만듭니다.

   cp config.sample.yaml config.yaml

2. Gmail OAuth2 자격 증명을 설정하세요.

   • Google Cloud Console 로 이동

   • 새 프로젝트를 생성하거나 기존 프로젝트를 선택하세요

   • Gmail API 활성화

   • OAuth2 자격 증명 만들기(데스크톱 애플리케이션 유형)

   • 클라이언트 구성 다운로드

3. 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

용법

이메일 확인

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

사용 가능한 옵션:

• --folder : 검사할 폴더를 지정합니다(기본값: INBOX)

• --limit : 표시할 이메일의 최대 개수(기본값: 10)

• --verbose : 자세한 로깅 출력을 활성화합니다.

MCP 서버 시작

IMAP MCP 서버를 시작하려면:

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

OAuth2 토큰 관리

OAuth2 토큰을 새로 고치려면:

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

개발

개발 환경 설정

테스트 실행

보안 고려 사항

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

• 환경 변수 또는 보안 자격 증명 저장소를 사용하여 이메일 자격 증명을 안전하게 저장합니다.

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

• 사용 사례에 필요한 것만으로 폴더 액세스를 제한하세요.

• 이메일 제공자 설정에서 서버에 부여된 권한을 검토하세요.

프로젝트 로드맵

• [x] 프로젝트 초기화 및 저장소 설정

• [x] 기본 IMAP 통합

• [x] 이메일 리소스 구현

• [x] 이메일 도구 구현

• [x] 이메일 답장 및 초안 기능

• [ ] 사용자 선호도 학습 구현

• [ ] 고급 검색 기능

• [ ] 다중 계정 지원

• [ ] 주요 이메일 제공업체와의 통합

기여하다

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

특허

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

감사의 말

• 프레임워크를 제공하기 위한 모델 컨텍스트 프로토콜

• 클로드를 개발하기 위한 인류학적

• 이 프로젝트를 가능하게 하는 다양한 Python IMAP 라이브러리