K Mail MCP
AI-powered unified inbox for Korean mail (Naver, Daum, and IMAP support mailing services) ยท MCP Plugin for Claude Desktop
Ask AI about K Mail MCP
Powered by Claude ยท Grounded in docs
I know everything about K Mail MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
K-Mail-MCP
Korean Mail MCP Server โ ๋ค์ด๋ฒยท๋ค์ยทGmailยท๋ค์ดํธยทYahooยทiCloud๋ฅผ Claude AI์ ์ฐ๊ฒฐํ๋ MCP ํ๋ฌ๊ทธ์ธ
English summary: K-Mail-MCP is an MCP (Model Context Protocol) server that connects 6 mail services โ Naver, Daum/Kakao, Gmail, Nate, Yahoo, and iCloud โ to Claude AI. It enables AI-powered email summarization, translation, spam detection, and unified inbox management โ all with AES-256-GCM encrypted credentials.
์ ๋ง๋ค์๋์?
Gmail์ ๊ณต์ MCP๊ฐ ์์ง๋ง, ํ๊ตญ์์ ์ฃผ๋ก ์ฌ์ฉํ๋ ๋ค์ด๋ฒยท๋ค์ ๋ฉ์ผ์ ์๋ฌด๊ฒ๋ ์์์ต๋๋ค. ๋ฉ์ผ์ ํ์ธํ๊ธฐ ์ํด ์ฌ๋ฌ ๋ฉ์ผ ์๋น์ค์ ์ผ์ผ์ด ๋ก๊ทธ์ธํ๋ ๊ฑด ๋ฒ๊ฑฐ๋ก์ด ์ผ์ด๋ผ, ํ ๋ฒ์ ์์ฝํ๊ณ ๋ณผ ์ ์๋๋ก Claude AI์ ํจ๊ป ๋ง๋ค์์ต๋๋ค.
โ ์์ธํ ์ด์ผ๊ธฐ๋ PHILOSOPHY.md๋ฅผ ์ฝ์ด์ฃผ์ธ์.
์ด๋ป๊ฒ ์ฌ์ฉํ๋์? โ ๋จผ์ ์ด๊ฒ๋ง ๊ฒฐ์ ํ์ธ์
์๋ ์ง๋ฌธ ํ๋์ ๋ตํ๋ฉด ํ์ํ ์ค์น ๊ฒฝ๋ก๊ฐ ์ ํด์ง๋๋ค.
"Claude Desktop ์ฑ์์๋ง ์ธ ๊ฑด๊ฐ์?" โ A. ๋ก์ปฌ ์ค์น (๊ฐ์ฅ ์ฌ์)
"claude.ai ์น/๋ชจ๋ฐ์ผ์์๋ ์ธ ๊ฑด๊ฐ์?" โ B. ์๊ฒฉ ์๋ฒ ์ค์น (๊ณ ๊ธ)
| A. ๋ก์ปฌ ์ค์น (Claude Desktop) | B. ์๊ฒฉ ์๋ฒ (claude.ai ์น/์ฑ) | |
|---|---|---|
| ๋์ด๋ | โญ ์ฌ์ (5๋ถ) | โญโญโญ ์ด๋ ค์ (์๋ฒ ํ์) |
| ํ์ํ ๊ฒ | PC + Claude Desktop | ์ธ๋ถ ์ ๊ทผ ๊ฐ๋ฅํ ์๋ฒ |
| ์ธ์ฆ | ์์ (๋ก์ปฌ ํ๋ก์ธ์ค) | OAuth 2.0 ๋ก๊ทธ์ธ |
| ์์ | ๐ A ์น์ ์ผ๋ก ์ด๋ | ๐ B ์น์ ์ผ๋ก ์ด๋ |
A. ๋ก์ปฌ ์ค์น (Claude Desktop) โ 5๋ถ
1๋จ๊ณ: ์ฌ์ ์๊ตฌ์ฌํญ ํ์ธ
- Node.js v20 ์ด์ ์ค์น ํ์ธ: ํฐ๋ฏธ๋์์
node --version์คํv20.x.x์ด์์ด๋ฉด ํต๊ณผ. ์๋๋ฉด nodejs.org์์ LTS ๋ฒ์ ์ค์น
- Claude Desktop ์ค์น: claude.ai/download
2๋จ๊ณ: ๋ค์ด๋ก๋ ๋ฐ ์ค์น
git clone https://github.com/youngsooco/k-mail-mcp.git
cd k-mail-mcp
๋๋ Releases์์ ZIP ๋ค์ด๋ก๋ ํ ์์ถ ํด์ .
Windows:
install.bat ํ์ผ์ ๋๋ธํด๋ฆญ
macOS/Linux:
chmod +x install.sh && ./install.sh
์ค์น ์คํฌ๋ฆฝํธ๊ฐ ์๋์ผ๋ก ํจํค์ง ์ค์น + Claude Desktop ์ค์ ํ์ผ ์ฐ๊ฒฐ๊น์ง ์๋ฃํฉ๋๋ค.
3๋จ๊ณ: ๋ฉ์ผ ๊ณ์ ๋ฑ๋ก
โ ๏ธ ์ฑ ๋น๋ฐ๋ฒํธ๊ฐ ํ์ํฉ๋๋ค โ ๋ก๊ทธ์ธ ๋น๋ฐ๋ฒํธ์ ๋ค๋ฆ ๋๋ค. ์๋น์ค๋ณ ๋ฐ๊ธ ๋ฐฉ๋ฒ ์น์ ์ ๋จผ์ ํ์ธํ์ธ์.
Windows:
setup.bat ํ์ผ์ ๋๋ธํด๋ฆญ
macOS/Linux:
chmod +x setup.sh && ./setup.sh
๋ํํ ๋ฉ๋ด๊ฐ ์ด๋ฆฝ๋๋ค:
============================================
ํ๊ตญ ๋ฉ์ผ MCP - ๊ณ์ ์ค์
============================================
1) ๊ณ์ ์ถ๊ฐ / ์์
2) ๊ณ์ ๋ชฉ๋ก
3) ๊ณ์ ์ญ์
4) AI ์คํธ ํํฐ ์ค์ (Claude Haiku API ํค) (๋ฏธ๋ฑ๋ก)
5) ์ข
๋ฃ
1์ ์ ํ โ ์๋น์คยท์ด๋ฉ์ผยท์ฑ ๋น๋ฐ๋ฒํธยท๋ณ์นญ ์
๋ ฅ. ์
๋ ฅ๊ฐ์ AES-256-GCM์ผ๋ก ์ํธํ๋์ด ์ ์ฅ๋ฉ๋๋ค.
4๋จ๊ณ: Claude Desktop ์ฌ์์
Claude Desktop์ ํธ๋ ์ด์์ ์์ ํ ์ข
๋ฃ ํ ๋ค์ ์คํ. ์ข์ธก ๋๊ตฌ ๋ฉ๋ด์์ k-mail-mcp๊ฐ ๋ณด์ด๋ฉด ์๋ฃ์
๋๋ค.
์ด์ Claude์์ ๋ง์ ๊ฑธ์ด๋ณด์ธ์:
"์ ๋ฉ์ผ ํ์ธํด์ค"
"์ค๋ ๋ฐ์ ๋ฉ์ผ ์์ฝํด์ค"
"์๋ฌธ ๋ฉ์ผ ๋ฒ์ญํด์ค"
์๋น์ค๋ณ ์ฑ ๋น๋ฐ๋ฒํธ ๋ฐ๊ธ ๋ฐฉ๋ฒ
์ฑ ๋น๋ฐ๋ฒํธ = IMAP ์ ์ฉ ๋ณ๋ ๋น๋ฐ๋ฒํธ. ๋ก๊ทธ์ธ ๋น๋ฐ๋ฒํธ๋ก๋ ์ฐ๊ฒฐ์ด ๊ฑฐ๋ถ๋ฉ๋๋ค.
๋ค์ด๋ฒ ๋ฉ์ผ
- ๋ค์ด๋ฒ ๋ณด์์ค์ ์ ์
2๋จ๊ณ ์ธ์ฆโ ํ์ฑํ (๋ฏธํ์ฑ ์ ์ฑ ๋น๋ฐ๋ฒํธ ๋ฐ๊ธ ๋ถ๊ฐ)์ ํ๋ฆฌ์ผ์ด์ ๋น๋ฐ๋ฒํธโ์ถ๊ฐโ ์ด๋ฆ ์ ๋ ฅ (์: Claude) โ ๋ฐ๊ธ- ์์ฑ๋ ๋น๋ฐ๋ฒํธ ๋ณต์ฌ โ ์ฐฝ ๋ซ์ผ๋ฉด ๋ค์ ๋ณผ ์ ์์
- ๋ค์ด๋ฒ ๋ฉ์ผ โ ํ๊ฒฝ์ค์ โ
IMAP/SMTP ์ค์ โ ์ฌ์ฉํจ ์ฒดํฌ setup.bat์คํ โ ๋ค์ด๋ฒ ๊ณ์ ๋ฑ๋ก ์ ๋ณต์ฌํ ๋น๋ฐ๋ฒํธ ์ ๋ ฅ
๋ค์/์นด์นด์ค ๋ฉ์ผ
- ๋ค์ ๋ฉ์ผ โ ์ค์ โ
IMAP/POP3ํญ - IMAP ์ฌ์ฉ โ ์ฌ์ฉํจ ์ ํ
[๋น๋ฐ๋ฒํธ ํ์ธํ๊ธฐ]ํด๋ฆญ โ ์นด์นด์ค ์ธ์ฆ โ ํ์๋ ๋น๋ฐ๋ฒํธ ๋ณต์ฌsetup.bat์คํ โ ๋ค์ ๊ณ์ ๋ฑ๋ก ์ ๋ณต์ฌํ ๋น๋ฐ๋ฒํธ ์ ๋ ฅ
๋ค์์ ๋ณ๋ ๋ฐ๊ธ์ด ์๋๋ผ, ์ ํ๋ฉด์์ ์ด๋ฏธ ์์ฑ๋ ์ ์ฉ ๋น๋ฐ๋ฒํธ๋ฅผ ํ์ธํ๋ ๋ฐฉ์์ ๋๋ค.
Gmail
- Google ๊ณ์ โ
๋ณด์ํญ 2๋จ๊ณ ์ธ์ฆํ์ฑํ (๋ฏธํ์ฑ ์ ์ฑ ๋น๋ฐ๋ฒํธ ๋ฐ๊ธ ๋ถ๊ฐ)- ๊ฒ์์ฐฝ์
์ฑ ๋น๋ฐ๋ฒํธ๊ฒ์ โ ํด๋ฆญ - ์ฑ ์ด๋ฆ ์
๋ ฅ (์: Claude) โ
๋ง๋ค๊ธฐ - ์์ฑ๋ 16์๋ฆฌ ๋น๋ฐ๋ฒํธ ๋ณต์ฌ โ ์ฐฝ ๋ซ์ผ๋ฉด ๋ค์ ๋ณผ ์ ์์
setup.bat์คํ โ Gmail ๊ณ์ ๋ฑ๋ก ์ ๋ณต์ฌํ ๋น๋ฐ๋ฒํธ ์ ๋ ฅ
๋ค์ดํธ
- ๋ค์ดํธ ๋ฉ์ผ โ ์ค์ โ ์ธ๋ถ ๋ฉ์ผ ์ฑ ์ฐ๊ฒฐ
- IMAP ์ฌ์ฉ โ ํ์ฑํ
- 2๋จ๊ณ ์ธ์ฆ ๋ฏธ์ฌ์ฉ ์ ๋ก๊ทธ์ธ ๋น๋ฐ๋ฒํธ ๊ทธ๋๋ก ์ฌ์ฉ ๊ฐ๋ฅ
- 2๋จ๊ณ ์ธ์ฆ ์ฌ์ฉ ์ค์ด๋ฉด ๋ณด์ ์ค์ ์์ ์ฑ ๋น๋ฐ๋ฒํธ ๋ฐ๊ธ
โ ๏ธ ๋ฏธ๊ฒ์ฆ ์๋น์ค: ์ถฉ๋ถํ ํ ์คํธ๋์ง ์์์ต๋๋ค.
Yahoo
- Yahoo ๊ณ์ ๋ณด์ ์ ์
์ฑ ๋น๋ฐ๋ฒํธ ์์ฑโ ์ฑ ์ด๋ฆ ์ ๋ ฅ โ 16์๋ฆฌ ๋น๋ฐ๋ฒํธ ๋ณต์ฌsetup.bat์คํ โ Yahoo ๊ณ์ ๋ฑ๋ก ์ ๋ณต์ฌํ ๋น๋ฐ๋ฒํธ ์ ๋ ฅ
โ ๏ธ ๋ฏธ๊ฒ์ฆ ์๋น์ค: ์ถฉ๋ถํ ํ ์คํธ๋์ง ์์์ต๋๋ค.
iCloud
- Apple ID โ
๋ก๊ทธ์ธ ๋ฐ ๋ณด์ ์ฑ ์ ์ฉ ์ํธโ์ํธ ์์ฑโ ์ด๋ฆ ์ ๋ ฅ โ ๋น๋ฐ๋ฒํธ ๋ณต์ฌsetup.bat์คํ โ iCloud ๊ณ์ ๋ฑ๋ก ์ ๋ณต์ฌํ ๋น๋ฐ๋ฒํธ ์ ๋ ฅ
iCloud๋ 2๋จ๊ณ ์ธ์ฆ์ด ํญ์ ์ผ์ ธ ์์ด ์ฑ ์ ์ฉ ์ํธ๊ฐ ํ์์ ๋๋ค. โ ๏ธ ๋ฏธ๊ฒ์ฆ ์๋น์ค: ์ถฉ๋ถํ ํ ์คํธ๋์ง ์์์ต๋๋ค.
B. ์๊ฒฉ ์๋ฒ ์ค์น (claude.ai ์น/์ฑ)
์ด ์น์ ์ claude.ai ์น ๋๋ ๋ชจ๋ฐ์ผ ์ฑ์์ ์ง์ K-Mail-MCP๋ฅผ ์ฌ์ฉํ๊ณ ์ถ์ ๋๋ง ํ์ํฉ๋๋ค. Claude Desktop๋ง ์ฌ์ฉํ๋ค๋ฉด ์์ A ์น์ ๋ง์ผ๋ก ์ถฉ๋ถํฉ๋๋ค.
์๋ ๋ฐฉ์
claude.ai (Anthropic ํด๋ผ์ฐ๋)
โ ์๋ ํ์: GET /.well-known/oauth-authorization-server
โ ์๋ ๋ฑ๋ก: POST /register
โ ์ฌ์ฉ์ ๋ธ๋ผ์ฐ์ : GET /authorize โ API ํค ์
๋ ฅ ํ์ด์ง
โ ์ธ์ฆ ์๋ฃ: POST /token โ access token ๋ฐ๊ธ
โ MCP ์ฐ๊ฒฐ: POST /mcp + Bearer token
๋ด ์๋ฒ (๊ณต์ธ IP ๋๋ Tunnel)
์ฌ์ ์๊ตฌ์ฌํญ
- ์ธ๋ถ์์ ์ ๊ทผ ๊ฐ๋ฅํ ์๋ฒ (๊ณต์ธ IP, Cloudflare Tunnel, Tailscale Funnel ๋ฑ)
- Node.js v20+
MCP_API_KEYํ๊ฒฝ๋ณ์ (์ด ๊ฐ์ด OAuth ๋ก๊ทธ์ธ ๋น๋ฐ๋ฒํธ)
์๋ฒ ์์
export MAIL_MCP_HTTP_PORT=8766
export MCP_API_KEY="์ํ๋-๋น๋ฐํค" # ๋ก๊ทธ์ธ ์ ์
๋ ฅํ ๊ฐ
export MAIL_MCP_BASE_URL="https://your-domain.com" # ์ธ๋ถ ์ ๊ทผ ๊ฐ๋ฅํ URL (/ ์์ด)
node index.js
์ ์ ์์ ๋ก๊ทธ:
[k-mail-mcp] v1.4.5 OAuth2 MCP ์๋ฒ ์์ โ port 8766
issuer: https://your-domain.com
MCP: https://your-domain.com/mcp
metadata: https://your-domain.com/.well-known/oauth-authorization-server
Cloudflare Tunnel๋ก ์ธ๋ถ ๋ ธ์ถ (๊ณ ์ IP ์์ ๋)
# cloudflared ์ค์น: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/
# ์์ ํฐ๋ (URL ๋งค๋ฒ ๋ณ๊ฒฝ)
cloudflared tunnel --url http://localhost:8766
# ์ถ๋ ฅ๋ URL์ MAIL_MCP_BASE_URL์ ์ฌ์ฉ
CF Tunnel ๋ฌด๋ฃ ํ๋์ ์ปค์คํ ๋๋ฉ์ธ ์์ด๋ ์ฌ์ฉ ๊ฐ๋ฅํฉ๋๋ค. ๋จ, ๋๋ค URL์ด ์ฌ์์๋ง๋ค ๋ณ๊ฒฝ๋ฉ๋๋ค. ๊ณ ์ URL์ด ํ์ํ๋ฉด Cloudflare ๊ณ์ ์ฐ๊ฒฐ ํ ์ปค์คํ ๋๋ฉ์ธ์ ์ค์ ํ์ธ์.
claude.ai์์ ์ฐ๊ฒฐํ๊ธฐ
- claude.ai โ ์ค์ (Settings) โ ์ฐ๊ฒฐ(Connections)
- MCP ์๋ฒ ์ถ๊ฐ(Add MCP Server) ํด๋ฆญ
- ์ ๋ ฅ:
| ํญ๋ชฉ | ๊ฐ |
|---|---|
| ์ด๋ฆ | k-mail-mcp (์ํ๋ ์ด๋ฆ) |
| URL | https://your-domain.com/mcp |
| OAuth ํด๋ผ์ด์ธํธ ID | ๋น์๋๊ธฐ (์๋ ๋ฑ๋ก) |
| OAuth ํด๋ผ์ด์ธํธ ์ํฌ๋ฆฟ | ๋น์๋๊ธฐ (PKCE ์ ์ฉ) |
- ์ ์ฅ โ ์ฐ๊ฒฐ ํด๋ฆญ
- ๋ธ๋ผ์ฐ์ ์ ๋ก๊ทธ์ธ ํ์ด์ง ํ์ โ
MCP_API_KEY๊ฐ ์ ๋ ฅ โ ์ฐ๊ฒฐ ํ์ฉ - ์๋ฃ โ claude.ai์์ k-mail-mcp ํด ์ฌ์ฉ ๊ฐ๋ฅ
ํ ํฐ ์ ํจ ๊ธฐ๊ฐ
- ์ก์ธ์ค ํ ํฐ: 30์ผ (์ฌ๋ก๊ทธ์ธ ๋ถํ์)
- ์๋ฒ ์ฌ์์ ์ ๋ชจ๋ ํ ํฐ ์ด๊ธฐํ โ ์ฌ๋ก๊ทธ์ธ ํ์
- ๋ง๋ฃ ์ claude.ai๊ฐ ์๋์ผ๋ก ์ฌ์ธ์ฆ ํ์ด์ง ํ์
์ฃผ์ ๊ธฐ๋ฅ
- ๋ฉํฐ ๊ณ์ ํตํฉ โ ๋ค์ด๋ฒ, ๋ค์/์นด์นด์ค, Gmail ๊ณ์ ์ ํ๋์ MCP๋ก ์ฐ๊ฒฐ
- ์ ์ฒด ํด๋ ์ํ โ INBOX๋ฟ ์๋๋ผ ๋ชจ๋ IMAP ํด๋๋ฅผ ์๋ ๋ฐ๊ฒฌํ์ฌ ์ํ
- ์ฆ๋ถ ์์ง โ ๋ง์ง๋ง ํ์ธ ์ดํ ์ฝ์ง ์์ ๋ฉ์ผ๋ง ๊ฐ์ ธ์ด
- AI ์๋ ๋ถ๋ฅ โ ๋ง์ถคํ ์นดํ
๊ณ ๋ฆฌ๋ก ์๋ ๋ถ๋ฅ (
categories.json์ผ๋ก ์ปค์คํฐ๋ง์ด์ง) - ์นดํ ๊ณ ๋ฆฌ ์๋ ์์ฑ โ ์ค์ ๋ฉ์ผ ํจํด์ AI๊ฐ ๋ถ์ํด ๋๋ง์ ์นดํ ๊ณ ๋ฆฌ ๊ท์น ์์ฑ
- ์๋ฌธ ๋ฉ์ผ ๋ฒ์ญ โ ์๋ฌธ ๋ฉ์ผ ์๋ ๊ฐ์ง ํ Claude๊ฐ ํ๊ตญ์ด๋ก ๋ฒ์ญยท์์ฝ
- ๋ฉ์ผ ๋งํฌ โ Gmail์ ํด๋น ๋ฉ์ผ ๋ฅ๋งํฌ, ๋ค์ด๋ฒยท๋ค์์ ๋ฐ์ํธ์งํจ ๋งํฌ ์ ๊ณต
- ์์ ์ํธํ โ ์ด๋ฉ์ผ ์ฃผ์ + ๋น๋ฐ๋ฒํธ + API ํค ๋ชจ๋ AES-256-GCM ์ํธํ ์ ์ฅ
- ์ธ์คํด์ค ๊ฒฉ๋ฆฌ โ ์ค์น๋ณธ๋ง๋ค ๊ณ ์ ํค ์์ฑ, ๋ค๋ฅธ PC์ ๋ฐ์ดํฐ ๊ณต์ ๋ถ๊ฐ
- OAuth 2.0 ์๊ฒฉ ์ ์ โ claude.ai custom connector๋ก ์๊ฒฉ ์ฐ๊ฒฐ (v1.4.0+)
์ฌ์ฉ ๋ฐฉ๋ฒ
Claude์์ ์์ฐ์ด๋ก ๋งํ๋ฉด ๋ฉ๋๋ค:
"์ ๋ฉ์ผ ํ์ธํด์ค"
"์ค๋ ๋ฐ์ ๋ฉ์ผ ์นดํ
๊ณ ๋ฆฌ๋ณ๋ก ์ ๋ฆฌํด์ค"
"์๋ฌธ ๋ฉ์ผ๋ง ๋ฒ์ญํด์ ์์ฝํด์ค"
"๋ค์ ๊ณ์ ์์ ์ฝ์ง ์์ ๋ฉ์ผ ๋ณด์ฌ์ค"
"AI ๊ด๋ จ ๋ฉ์ผ๋ง ์ฐพ์์ค"
"์ ๋ฒ์ ํ์ธํ ์ดํ๋ก ์ ๋ฉ์ผ ์์ด?"
"๋ด ๋ฉ์ผ ํจํด ๋ณด๊ณ ์นดํ
๊ณ ๋ฆฌ ์๋์ผ๋ก ๋ง๋ค์ด์ค"
"์ด๋ค ํด๋๋ค์ ์ค์บํ๊ณ ์์ด?"
"์นดํํธ์งํจ์ ์ค์บ์์ ๋นผ์ค"
MCP Tool ๋ชฉ๋ก
| Tool | ์ค๋ช |
|---|---|
check_new_mails | ์ฝ์ง ์์ ๋ฉ์ผ ์์ง, ์ ์ฒด ํด๋ ์ํ, 4๋จ๊ณ ์คํธ ํ์ง ํฌํจ |
list_accounts | ๋ฑ๋ก๋ ๊ณ์ ๋ชฉ๋ก ๋ฐ ํด๋ ์ค์บ ํํฉ ํ์ธ |
read_email | ํน์ ๋ฉ์ผ ์ ์ฒด ๋ณธ๋ฌธ ์ฝ๊ธฐ (max_chars๋ก ๊ธธ์ด ์ ํ ๊ฐ๋ฅ) |
reset_last_run | ๋ง์ง๋ง ์คํ ์๊ฐ ์ด๊ธฐํ (๊ณ์ ๋ณ / ๋ ์ง ์ง์ ๊ฐ๋ฅ) |
list_mailboxes | IMAP ํด๋ ๋ชฉ๋ก ๋ฐ ๋ฐ๊ฒฌ/์ ์ธ/์ ํจ ํํฉ ํ์ธ |
generate_categories | ๋ฉ์ผ ํจํด AI ๋ถ์ โ ๋ง์ถค ์นดํ ๊ณ ๋ฆฌ ์๋ ์์ฑ |
get_watched_mailboxes | ๊ณ์ ๋ณ ํด๋ ๋ฐ๊ฒฌ/์ ์ธ/์ ํจ ์ค์บ ํํฉ ์กฐํ |
set_watched_mailboxes | ์ค์บ ์ ์ธ ํด๋ ๊ด๋ฆฌ (์ถ๊ฐ / ์ ๊ฑฐ / ์ด๊ธฐํ) |
์ง์ ๋ฉ์ผ ์๋น์ค
| ์๋น์ค | ์ด๋ฉ์ผ ๋๋ฉ์ธ | IMAP ์ฃผ์ | ๊ฒ์ฆ ์ํ |
|---|---|---|---|
| ๋ค์ด๋ฒ | @naver.com | imap.naver.com | โ ๊ฒ์ฆ์๋ฃ |
| ๋ค์/์นด์นด์ค | @daum.net @kakao.com | imap.daum.net | โ ๊ฒ์ฆ์๋ฃ |
| Gmail | @gmail.com | imap.gmail.com | โ ๊ฒ์ฆ์๋ฃ |
| ๋ค์ดํธ | @nate.com | imap.nate.com | โ ๏ธ ๋ฏธ๊ฒ์ฆ |
| Yahoo | @yahoo.com | imap.mail.yahoo.com | โ ๏ธ ๋ฏธ๊ฒ์ฆ |
| iCloud | @icloud.com @me.com | imap.mail.me.com | โ ๏ธ ๋ฏธ๊ฒ์ฆ |
โ ๏ธ ๋ฏธ๊ฒ์ฆ ์๋น์ค ์ฌ์ฉ์ ๋ถ๋ค๊ป: ๋์ ์ฌ๋ถ(์ฑ๊ณตยท์คํจยท์ค๋ฅ ๋ฉ์์ง)๋ฅผ GitHub Issues์ ์๋ ค์ฃผ์๋ฉด ๋น ๋ฅด๊ฒ ๋ฐ์ํ๊ฒ ์ต๋๋ค.
์ง์ํ์ง ์๋ ์๋น์ค
| ์๋น์ค | ์ด์ |
|---|---|
| Outlook.com / Microsoft 365 | OAuth 2.0 ์ธ์ฆ ํ์ (์ฑ ๋น๋ฐ๋ฒํธ ๋ฐฉ์ ์ฐจ๋จ) |
| ๋ค์ด๋ฒ ์์ค | B2B ์ ์ฉ, IMAP ์ค์ ๋น๊ณต๊ฐ |
| ์นด์นด์ค ์ํฐํ๋ผ์ด์ฆ | ๊ธฐ์ ๊ณ์ฝ ํ์ |
| ์ฌ๋ด ๋ฉ์ผ | IMAP ํ์ฑํ ์ฌ๋ถ ํ์ฌ ์ ์ฑ ์ ๋ฐ๋ผ ๋ค๋ฆ |
IMAP ์ค์ ์ ์๋ ๊ฒฝ์ฐ
index.js์PRESETS๊ฐ์ฒด์ ์ง์ ์ถ๊ฐ ๊ฐ๋ฅํฉ๋๋ค. CONTRIBUTING.md ์ฐธ๊ณ
์ง์ ํ๋ซํผ
| ํ๋ซํผ | ์ง์ ์ฌ๋ถ | ๋น๊ณ |
|---|---|---|
| Windows 10/11 | โ | ๊ถ์ฅ ํ๊ฒฝ, ์ค์น ์คํฌ๋ฆฝํธ ๊ฒ์ฆ์๋ฃ |
| macOS | โ | Node.js ์ค์น ํ์, install.sh ๋ฏธ๊ฒ์ฆ |
| Linux | โ | install.sh ๋ฏธ๊ฒ์ฆ |
| iOS / Android | โ | Claude ์ฑ MCP ๋ฏธ์ง์ |
โ ๏ธ macOS / Linux ์ฌ์ฉ์ ๋ถ๋ค๊ป:
install.sh/setup.sh๋ ์ถฉ๋ถํ ๊ฒ์ฆ๋์ง ์์์ต๋๋ค. ๋์ ์ฌ๋ถ๋ฅผ GitHub Issues์ ์๋ ค์ฃผ์๋ฉด ๋น ๋ฅด๊ฒ ๋ฐ์ํ๊ฒ ์ต๋๋ค.
์นดํ ๊ณ ๋ฆฌ ์ปค์คํฐ๋ง์ด์ง
๋ฐฉ๋ฒ 1: AI ์๋ ์์ฑ (๊ถ์ฅ)
Claude: "๋ด ๋ฉ์ผ ํจํด ๋ณด๊ณ ์นดํ
๊ณ ๋ฆฌ ์๋์ผ๋ก ๋ง๋ค์ด์ค"
โ generate_categories ํด ์คํ
โ ๋ฏธ๋ฆฌ๋ณด๊ธฐ ํ์ธ ํ "์ ์ฅํด์ค" ์์ฒญ
๋ฐฉ๋ฒ 2: ์ง์ ํธ์ง
categories.json ํ์ผ์ ์์ ํ๋ฉด ๋ฉ๋๋ค (Claude Desktop ์ฌ์์ ๋ถํ์):
[
{
"name": "๐ฅ ์๋ฃ/ํฌ์ค์ผ์ด",
"keywords": ["๋ณ์", "์ฒ๋ฐฉ", "์ง๋ฃ", "์ฝ๊ตญ", "๊ฑด๊ฐ๊ฒ์ง", "clinic", "hospital"]
},
{
"name": "๐ ๊ต์ก/ํ์ต",
"keywords": ["๊ฐ์", "์๊ฐ", "coursera", "udemy", "์ธํ๋ฐ", "์๋ฃ"]
}
]
name: ์ด๋ชจ์ง + ์นดํ ๊ณ ๋ฆฌ๋ชkeywords: from(๋ฐ์ ์) + subject(์ ๋ชฉ)์์ ๊ฒ์ํ ํค์๋ (๋์๋ฌธ์ ๋ฌด์)newsletterOnly:true์ด๋ฉด List-Unsubscribe ํค๋ ์๋ ๋ฉ์ผ์๋ง ์ ์ฉcategories.json์๊ฑฐ๋ ๋น์ด์์ผ๋ฉด ๊ธฐ๋ณธ 9๊ฐ ์นดํ ๊ณ ๋ฆฌ ์๋ ์ฌ์ฉ
์คํธ ํ์ง โ 4๋จ๊ณ ํํฐ๋ง
| ๋จ๊ณ | ๋ฐฉ๋ฒ | ํ์ ์กฐ๊ฑด |
|---|---|---|
| 1๏ธโฃ | ํค์๋ ํจํด ๋งค์นญ | ์์ (๊ธฐ๋ณธ ๋์) |
| 2๏ธโฃ | Spamhaus DNSBL | ์์ (DNS ์ฟผ๋ฆฌ) |
| 3๏ธโฃ | SPF / DKIM / DMARC | ์์ (ํค๋ ํ์ฑ) |
| 4๏ธโฃ | Claude Haiku AI ํ๋จ | Anthropic API ํค (์ ํ) |
1~3๋จ๊ณ๋ ๋ณ๋ ์ค์ ์์ด ์๋ ๋์. 4๋จ๊ณ๋ setup.bat โ 4๋ฒ ๋ฉ๋ด๋ก API ํค ๋ฑ๋ก ์ ํ์ฑํ.
spamScore = ํจํด์ ์ + DNSBL์ ์ + ์ธ์ฆ์ ์(SPF/DKIM/DMARC) ยฑ AI์กฐ์
isSpam = spamScore >= 70
๋ฐ์ดํฐ ํ๋ฆ ๋ฐ ๋ณด์
์ฌ์ฉ์ ์
๋ ฅ (setup.bat / setup.sh)
โโ ์ด๋ฉ์ผ ์ฃผ์ + ์ฑ ๋น๋ฐ๋ฒํธ
โ โ AES-256-GCM ์ํธํ
โ accounts.enc.json
โ
โโ Anthropic API ํค (์ ํ)
โ AES-256-GCM ์ํธํ
settings.enc.json
.master.key โ ์ด ์ค์น๋ณธ ์ ์ฉ 256-bit ํค (์๋ ์์ฑ)
โ
MCP ์๋ฒ ์คํ ์ โ ๋ฉ๋ชจ๋ฆฌ์์๋ง ๋ณตํธํ โ IMAP ์ฐ๊ฒฐ / Haiku API ํธ์ถ
โ
์๋ฒ ์ข
๋ฃ โ ํ๋ฌธ ์์ ์๋ฉธ
- ๋น๋ฐ๋ฒํธยทAPI ํค๋ ํ์ผ์ ์ ๋ ํ๋ฌธ์ผ๋ก ์ ์ฅ๋์ง ์์ต๋๋ค
.master.key๋ ์ด PC์๋ง ์กด์ฌํฉ๋๋ค- Claude (Anthropic) ์๋ฒ๋ก ๋น๋ฐ๋ฒํธ๊ฐ ์ ์ก๋์ง ์์ต๋๋ค
OAuth 2.0 ๋ณด์ ์ค๊ณ (v1.4.0+)
| ํญ๋ชฉ | ๊ตฌํ |
|---|---|
| PKCE (S256) | ํ์ โ ์ธ๊ฐ ์ฝ๋ ํ์ทจ ๊ณต๊ฒฉ ๋ฐฉ์ด |
| API ํค ๋น๊ต | crypto.timingSafeEqual โ ํ์ด๋ฐ ๊ณต๊ฒฉ ๋ฐฉ์ด |
| Open Redirect ๋ฐฉ์ด | ํผ ์ ์ถ ์ redirect_uri๋ฅผ ๋ฑ๋ก๋ ๋ชฉ๋ก์์ ์ฌ๊ฒ์ฆ |
| auth code TTL | 5๋ถ |
| access token TTL | 30์ผ (์๋ฒ ์ฌ์์ ์ ์ด๊ธฐํ) |
| ํ ํฐ ์ ์ฅ | ์๋ฒ ์ธ๋ฉ๋ชจ๋ฆฌ โ ํ์ผยทDB ๋ฏธ๊ธฐ๋ก |
| ๋์ ํด๋ผ์ด์ธํธ ๋ฑ๋ก | RFC 7591 ์ง์ โ ์ฌ์ ๋ฑ๋ก ๋ถํ์ |
| HTML ์ธ์ ์ ๋ฐฉ์ด | ๋ก๊ทธ์ธ ํ์ด์ง escHtml() ์ ์ฒ๋ฆฌ |
๋ณด์ ํจ์น ์ด๋ ฅ
| ๋ฒ์ | ๋ด์ฉ |
|---|---|
| v1.2.1 | ํ๋กฌํํธ ์ธ์ ์
๋ฐฉ์ด, TLS ๊ฐ์ (rejectUnauthorized: true), ํ์ผ ๊ถํ 0o600 |
| v1.3.0 | GitHub Actions ์ํฌํ๋ก์ฐ hardening |
| v1.4.0 | OAuth 2.0, timingSafeEqual API ํค ๋น๊ต, Open Redirect ๋ฐฉ์ด, PKCE S256 ๊ฐ์ |
| v1.4.5 | Stateless transport (CAI ๋ก๋๋ฐธ๋ฐ์ฑ ๋์), express trust proxy ์ค์ |
์์ฃผ ๋ฌป๋ ์ง๋ฌธ
Claude Desktop (๋ก์ปฌ ๋ชจ๋)
Q. setup.bat์ ์คํํ๋๋ฐ ์๋ฌด๊ฒ๋ ์ ๋น๋๋ค.
A. node --version์ผ๋ก Node.js ๋ฒ์ ํ์ธ. v20 ๋ฏธ๋ง์ด๋ฉด nodejs.org์์ LTS ์ค์น ํ install.bat ๋จผ์ ์คํ.
Q. Claude Desktop์์ k-mail-mcp๊ฐ ๋ณด์ด์ง ์์ต๋๋ค.
A. install.bat ์ฌ์คํ โ Claude Desktop ํธ๋ ์ด์์ ์์ ์ข
๋ฃ โ ์ฌ์์.
Q. Claude Desktop ์
๋ฐ์ดํธ ํ MCP๊ฐ ์ฌ๋ผ์ก์ต๋๋ค.
A. install.bat์ ๋ค์ ์คํํ์ธ์.
Q. claude_desktop_config.json ํ์ผ์ด ์ด๋ ์๋์?
A. Windows ํ์๊ธฐ ์ฃผ์์ฐฝ์ %APPDATA%\Claude ์
๋ ฅ.
Q. ๋ค์ด๋ฒ IMAP ์ฐ๊ฒฐ ์ค๋ฅ๊ฐ ๋ฉ๋๋ค. A. โ 2๋จ๊ณ ์ธ์ฆ ํ์ฑํ โก ์ฑ ๋น๋ฐ๋ฒํธ ์ฌ๋ฐ๊ธ โข ๋ค์ด๋ฒ ๋ฉ์ผ โ IMAP/SMTP ์ค์ โ ์ฌ์ฉ ์ผ๊ธฐ
Q. ๋ค์ ๋ฉ์ผ ์ฐ๊ฒฐ์ด ์ ๋ฉ๋๋ค. A. ๋ค์ ๋ฉ์ผ ์น โ ํ๊ฒฝ์ค์ โ ์ธ๋ถ ๋ฉ์ผ ์ฑ ์ฐ๊ฒฐ โ IMAP ์ฌ์ฉ ์ผ๊ธฐ.
claude.ai ์๊ฒฉ MCP (OAuth ๋ชจ๋)
Q. "MCP ์๋ฒ๋ฅผ ์ฐพ์ ์ ์์ต๋๋ค" ์ค๋ฅ๊ฐ ๋ฉ๋๋ค.
A. ๋ธ๋ผ์ฐ์ ์์ https://your-domain.com/.well-known/oauth-authorization-server๋ฅผ ์ง์ ์ด์ด JSON์ด ๋ฐํ๋๋์ง ํ์ธ.
Q. OAuth ํด๋ผ์ด์ธํธ ID / ์ํฌ๋ฆฟ์ ๋ญ ์ ๋ ฅํด์ผ ํ๋์? A. ๋น์๋์ธ์. ๋์ ํด๋ผ์ด์ธํธ ๋ฑ๋ก(RFC 7591)์ผ๋ก ์๋ ์ฒ๋ฆฌ๋ฉ๋๋ค.
Q. ์๋ฒ ์ฌ์์ ํ ๋ค์ ๋ก๊ทธ์ธํ๋ผ๊ณ ํฉ๋๋ค. A. ์ ์์ ๋๋ค. ํ ํฐ์ด ์ธ๋ฉ๋ชจ๋ฆฌ์๋ง ์ ์ฅ๋๋ฏ๋ก ์ฌ์์ ์ ์ด๊ธฐํ๋ฉ๋๋ค.
Q. API ํค๋ ๋ฌด์์ธ๊ฐ์?
A. MCP_API_KEY ํ๊ฒฝ๋ณ์๋ก ์ค์ ํ ๊ฐ์
๋๋ค. OAuth ๋ก๊ทธ์ธ ํ์ด์ง์์ ์ด ๊ฐ์ ์
๋ ฅํฉ๋๋ค.
๊ณตํต
Q. .master.key๋ฅผ ์ค์๋ก ์ญ์ ํ์ต๋๋ค.
A. ๋ณต๊ตฌ ๋ถ๊ฐ. accounts.enc.json, .instance.json ์ญ์ ํ setup.bat์ผ๋ก ๊ณ์ ์ฌ๋ฑ๋ก.
Q. ์ฌ๋ฌ PC์์ ๊ฐ์ ๊ณ์ ์ ์ฐ๊ณ ์ถ์ต๋๋ค.
A. ๊ฐ PC์์ ๋
๋ฆฝ์ ์ผ๋ก setup.bat ์คํ. .master.key๋ ๋ณต์ฌํ์ง ๋ง์ธ์.
Q. iOS/Android์์ ์ฌ์ฉํ ์ ์๋์? A. ํ์ฌ Claude ์ฑ์ MCP๋ฅผ ์ง์ํ์ง ์์ ๋ถ๊ฐํฉ๋๋ค.
Q. ๋ค๋ฅธ ๋ฉ์ผ ์๋น์ค๋ฅผ ์ถ๊ฐํ ์ ์๋์?
A. IMAP์ ์ง์ํ๋ ๋ชจ๋ ์๋น์ค๋ index.js์ PRESETS ๊ฐ์ฒด์ ์ถ๊ฐ ๊ฐ๋ฅ. CONTRIBUTING.md ์ฐธ๊ณ .
Q. watched_mailboxes.json์ด git์ ์ฌ๋ผ๊ฐ๋๋ค.
A. v1.3.0๋ถํฐ .gitignore์ ์๋ ํฌํจ. ์ด๋ฏธ ์ฌ๋ผ๊ฐ ๊ฒฝ์ฐ: git rm --cached watched_mailboxes.json.
ํ์ผ ๊ตฌ์กฐ
k-mail-mcp/
โโโ index.js MCP ์๋ฒ ๋ณธ์ฒด โ stdio / HTTP+OAuth2 ๋์ผ ๋ชจ๋
โโโ oauth.js OAuth 2.0 Provider
โโโ categories.json ์นดํ
๊ณ ๋ฆฌ ๊ท์น (์ฌ์ฉ์ ์ ์ ๊ฐ๋ฅ)
โโโ install.bat Windows ์ค์น (๋๋ธํด๋ฆญ)
โโโ install.ps1 ์ค์น ๋ก์ง (PowerShell)
โโโ install.sh macOS/Linux ์ค์น
โโโ setup.bat Windows ๊ณ์ ยท์ค์ ๊ด๋ฆฌ (๋๋ธํด๋ฆญ)
โโโ setup.ps1 ๊ณ์ ยท์ค์ ๊ด๋ฆฌ UI (PowerShell)
โโโ setup.sh macOS/Linux ๊ณ์ ยท์ค์ ๊ด๋ฆฌ
โโโ setup-worker.js ์ํธํ/์ ์ฅ ์ฝ์ด
โโโ package.json
โโโ INSTALL_GUIDE.md ํ๋ซํผ๋ณ ์์ธ ์ค์น ๊ฐ์ด๋
โโโ CONTRIBUTING.md
โโโ PHILOSOPHY.md
โโโ ROADMAP.md
์๋ ์์ฑ ํ์ผ (๊ณต์ ๊ธ์ง):
accounts.enc.json ๊ณ์ ์ ๋ณด (AES-256-GCM ์ํธํ)
settings.enc.json API ํค ๋ฑ ์ค์ (AES-256-GCM ์ํธํ)
.master.key 256-bit ์ํธํ ํค (์ ๋ ๊ณต์ ยท๋ฐฑ์
๊ธ์ง)
.instance.json ์ธ์คํด์ค ์๋ณ์
last_run.json ๋ง์ง๋ง ์คํ ์๊ฐ
watched_mailboxes.json ํด๋ ๋ฐ๊ฒฌ ์บ์ (์ด PC ์ ์ฉ)
AI์ ํจ๊ป ๋ง๋ค๊ณ ์ ์งํฉ๋๋ค
์ด ํ๋ก์ ํธ๋ Claude AI (Anthropic)์ ํจ๊ป ์ค๊ณยท๊ฐ๋ฐยท๋ฌธ์ํ๋์ต๋๋ค.
| ์ญํ | ๋ด๋น |
|---|---|
| ์์ด๋์ด / ๋ฐฉํฅ ๊ฒฐ์ | dadfkim |
| ์ฝ๋ ์์ฑ / ๊ตฌ์กฐ ์ค๊ณ | Claude AI + dadfkim |
| ๋ฌธ์ ์์ฑ / ์ ์ง๋ณด์ | Claude AI + dadfkim |
| ์ด์ ์๋ ์๋ต | Claude AI (GitHub Actions) |
| PR ์ฝ๋ ๋ฆฌ๋ทฐ | Claude AI (GitHub Actions) |
| ๋ฆด๋ฆฌ์ฆ ๋ ธํธ ์๋ ์์ฑ | Claude AI (GitHub Actions) |
GitHub์์ ์ด์๋ฅผ ๋ฑ๋กํ๊ฑฐ๋ PR์ ์ฌ๋ฆฌ๋ฉด Claude AI๊ฐ ์๋์ผ๋ก ๊ฒํ ยท๋ต๋ณํฉ๋๋ค. ์ต์ข ๊ฒฐ์ ์ ํญ์ ์ฌ๋(๋ฉ์ธํ ์ด๋)์ด ํฉ๋๋ค.
๊ธฐ์ฌ์
- dadfkim โ dadfkim@hanmail.net ยท GitHub ยท LinkedIn
- Claude Sonnet (Anthropic) โ AI ๊ณต๋ ๊ฐ๋ฐ์ ยท ์๋ํ ์ ์ง๋ณด์
๊ธฐ์ฌ๋ฅผ ์ํ์๋ฉด CONTRIBUTING.md๋ฅผ ์ฝ์ด์ฃผ์ธ์.
๋ผ์ด์ ์ค
MIT License ยฉ 2026 dadfkim
