imap-mcp

IMAP 클라이언트 MCP입니다. Dovecot / Synology MailPlus 메일함에서 메일을 읽고, 선택적으로 새 메시지가 도착하면 웹훅을 실행합니다. 자동화 트리거를 위해 불안정한 Gmail OAuth를 대체합니다.

도구

도구	설명
`list_unread(mailbox, limit)`	읽지 않은 메시지 요약
`search(criteria, mailbox, limit)`	원시 IMAP SEARCH
`fetch(uid, mailbox)`	전체 메시지 (헤더 + 텍스트 + html)
`mark_read(uid, mailbox)`	`\Seen` 플래그 설정
`move(uid, source, dest)`	다른 폴더로 이동
`list_folders()`	모든 폴더
`get_status()`	IMAP 핑 + 감시 규칙 + 실행 횟수

환경 변수

변수	필수	설명
`IMAP_HOST`	✓	서버 (예: `192.168.68.61`)
`IMAP_PORT`		기본값 `993`
`IMAP_SSL`		`true` (기본값) 또는 `false`
`IMAP_USERNAME`	✓	이메일이 아닌 Synology 계정 이름
`IMAP_PASSWORD`	✓
`IMAP_DEFAULT_MAILBOX`		기본값 `INBOX`
`WATCHES_JSON`		감시 규칙의 인라인 JSON 배열
`WATCHES_FILE`		JSON 파일 경로 (기본값 `/data/watches.json`)
`POLL_INTERVAL_SECS`		기본값 `30`
`PORT`		MCP 서버 포트 (기본값 `38105`)

감시 규칙

[
  {
    "name": "garmin-livetrack",
    "mailbox": "INBOX",
    "criteria": "FROM \"noreply@garmin.com\" SUBJECT \"LiveTrack\" UNSEEN",
    "webhook_url": "http://host.docker.internal:5678/webhook/livetrack-mail",
    "mark_read": true,
    "move_to": null
  }
]

시작 시 감시자는 기존에 일치하는 UID로 각 규칙을 "준비(prime)"하므로, 부팅 후 새로 도착한 메일만 실행됩니다. POLL_INTERVAL_SECS마다 각 규칙의 기준을 다시 실행하고 일치하는 메시지(전체 본문)를 { "rule": "...", "mailbox": "...", "message": {...} } 형식으로 webhook_url에 POST합니다. 성공적으로 POST한 후에는 메시지를 move_to로 이동하거나 mark_read가 설정된 경우 읽음으로 표시합니다.