향상된 Gmail MCP 서버

Gmail 통합을 위한 강력하고 풍부한 기능을 갖춘 모델 컨텍스트 프로토콜(MCP) 서버로, Python으로 작성되었습니다. 이 서버는 Claude와 같은 AI 비서가 자연어를 통해 Gmail과 상호 작용할 수 있도록 지원하여 포괄적인 이메일 관리 기능을 제공합니다.

🌟 주요 특징

📧 완벽한 이메일 관리

• 사용자 정의 가능한 제목, 내용 및 수신자를 사용하여 이메일을 보내세요

• 전체 메타데이터로 이메일 콘텐츠를 읽고 검색합니다.

• 확인과 함께 이메일을 휴지통으로 이동

• 이메일을 읽음/읽지 않음으로 표시

• 브라우저에서 직접 이메일 열기

📝 초안 관리

• 나중에 검토할 수 있도록 초안 이메일을 작성하세요

• 모든 초안 이메일 나열

• 기존 초안 편집

🏷️ 고급 라벨 관리

• 사용 가능한 모든 라벨을 나열하세요

• 사용자 정의 라벨 만들기

• 이메일에 라벨 적용/제거

• 기존 라벨 이름 바꾸기

• 사용하지 않는 라벨 삭제

• 라벨로 이메일 검색

📁 폴더 구성

• 새 폴더 만들기(Gmail 라벨로 구현됨)

• 폴더 간에 이메일 이동

• 사용 가능한 모든 폴더 나열

🔍 강력한 검색 및 필터링

• Gmail의 고급 쿼리 구문을 사용하여 이메일 검색

• 이메일 필터를 만들고, 관리하고, 삭제합니다.

• 보낸 사람, 받는 사람, 제목, 내용 등으로 필터링

• 유연한 매개변수로 검색 결과를 사용자 정의하세요

🗄️ 아카이브 관리

• 이메일 보관(삭제하지 않고 받은 편지함에서 제거)

• 검색 기준과 일치하는 여러 이메일을 일괄 보관합니다.

• 보관된 모든 이메일 나열

• 보관된 이메일을 받은 편지함으로 복원

Related MCP server: GCP MCP

🚀 시작하기

필수 조건

• 파이썬 3.8 이상

• Gmail API가 활성화된 Google Cloud 프로젝트

• OAuth 2.0 자격 증명

설치

지엑스피1

Google 클라우드 설정

1. 새로운 Google Cloud 프로젝트를 만듭니다.

2. Gmail API 활성화

3. OAuth 동의 화면 구성:

   • "외부" 사용자 유형을 선택하세요

   • 테스트 사용자로 이메일을 추가하세요

   • 범위 추가: https://www.googleapis.com/auth/gmail/modify

4. OAuth 2.0 자격 증명을 만듭니다.

   • 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요

   • JSON 자격 증명 파일을 다운로드하세요

구성

서버를 실행할 때 자격 증명을 안전하게 저장하고 해당 위치를 지정하세요.

🔧 사용법

Claude Desktop으로 실행

Claude Desktop 구성 파일(일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json )에 다음을 추가합니다.

MCP Inspector로 테스트

테스트 및 디버깅을 위해 MCP Inspector를 사용하세요.

🔐 보안 고려 사항

• 자격 증명이나 토큰 파일을 버전 제어에 커밋하지 마십시오.

• 적절한 권한이 있는 안전한 위치에 자격 증명을 저장하세요.

• 서버는 민감한 작업을 수행하기 전에 사용자 확인을 요청합니다.

• 비정상적인 활동이 있는지 Google Cloud Console을 정기적으로 검토하세요.

• 민감한 경로에 환경 변수 사용을 고려하세요

🛠️ 건축

이 구현은 Google API 클라이언트 라이브러리를 통해 모든 Gmail 작업을 처리하는 포괄적인 단일 파일 아키텍처를 특징으로 합니다. 주요 구성 요소는 다음과 같습니다.

• 자동 토큰 새로 고침을 통한 OAuth2 인증

• 포괄적인 오류 처리 및 로깅

• 명확한 입력 스키마를 갖춘 구조화된 도구 정의

• 효율적인 이메일 구문 분석 및 서식 지정

📚 예시 프롬프트

Gmail MCP 서버를 연결한 후 Claude에게 다음 메시지를 시도해 보세요.

• "읽지 않은 이메일 보여줘"

• "첨부 파일이 있는 example@domain.com 에서 온 이메일 검색"

• "중요 프로젝트"라는 새 라벨을 만듭니다.

• " john@example.com 으로 다가오는 회의에 대한 이메일을 작성하세요"

• " newsletter@example.com 에서 온 모든 이메일을 보관합니다."

• "내 팀의 이메일에 자동으로 레이블을 지정하는 필터를 만듭니다."

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기

📄 라이센스

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

🙏 감사의 말

• 커뮤니티의 다양한 MCP 서버 구현에서 영감을 얻었습니다.

• 모델 컨텍스트 프로토콜 프레임워크로 구축됨

• Google의 공식 API 클라이언트 라이브러리를 사용합니다.