Yahoo Mail MCP 서버

LLM이 Yahoo Mail과 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 사용하면 Claude Desktop과 같은 도구가 안전한 OAuth2 인증을 통해 Yahoo 계정에서 직접 이메일을 읽고, 검색하고, 보낼 수 있습니다.

기능 (계획)

• 이메일 읽기: 받은 편지함에서 최근 메시지를 가져옵니다.

• 이메일 검색: 키워드, 발신자 또는 날짜를 사용하여 특정 메시지를 검색합니다.

• 이메일 보내기: Yahoo의 SMTP 서버를 사용하여 이메일을 작성하고 보냅니다.

사전 요구 사항

• Node.js: 버전 20 이상.

• Yahoo 개발자 앱: OAuth2 자격 증명을 얻으려면 Yahoo 개발자 포털에서 앱을 만들어야 합니다.

OAuth2용 Yahoo 앱 만들기

1. Yahoo 개발자 포털로 이동합니다.

2. 새 앱을 만듭니다.

3. API 권한을 Mail(읽기 및 쓰기)을 포함하도록 설정합니다.

4. 리디렉션 URI를 https://localhost/callback(또는 선호하는 URI)으로 설정합니다.

5. 클라이언트 ID와 클라이언트 암호를 기록해 둡니다.

설정

1. 저장소 복제:

   git clone <repository-url>
   cd yahoo-mail-mcp

2. 종속성 설치:

   npm install

3. 환경 변수 구성: 루트 디렉토리에 .env 파일을 만들고 Yahoo 자격 증명을 추가합니다:

   YAHOO_EMAIL=your-email@yahoo.com
   YAHOO_CLIENT_ID=your-client-id
   YAHOO_CLIENT_SECRET=your-client-secret
   YAHOO_REDIRECT_URI=https://localhost/callback

인증

서버를 처음 실행하면 OAuth2 흐름이 트리거됩니다:

1. 브라우저 창이 열리고 Yahoo 로그인을 요청합니다.

2. 승인 후 REDIRECT_URI로 리디렉션됩니다.

3. 페이지 로드에 실패할 수 있지만 괜찮습니다. 주소 표시줄에서 code 매개변수를 복사하세요.

4. 코드를 터미널에 다시 붙여넣습니다.

5. 서버가 코드를 토큰으로 교환하고 .tokens.json에 안전하게 저장합니다.

사용법

개발

vite-node를 사용하여 개발 모드에서 서버를 실행하려면:

npm run dev

빌드

프로덕션용으로 프로젝트를 빌드하려면:

npm run build

Claude Desktop과 통합

이 서버를 Claude Desktop과 함께 사용하려면 claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "yahoo-mail": {
      "command": "node",
      "args": ["/path/to/yahoo-mail-mcp/dist/index.js"]
    }
  }
}

프로젝트 구조

• src/index.ts: MCP 서버의 진입점.

• src/server.ts: MCP 서버 초기화 및 도구 등록.

• src/auth/: OAuth2 흐름 및 토큰 관리.

• src/tools/: 개별 이메일 도구 구현.

• src/lib/: IMAP 및 SMTP 연결을 위한 도우미 라이브러리.

라이선스

ISC