MCP 服务器

phison-mail-mcp

Enables AI models to send, receive, search, and manage emails via SMTP/IMAP, including support for attachments, contacts, and advanced search.

README

Mail MCP 工具

English Version (README-EN.md)

這是什麽

這是一個基於 MCP (Model Context Protocol) 的郵件工具，它能讓 AI 模型通過標準化接口訪問電子郵件服務。

簡單來說，它讓 AI 助手能夠執行各種郵件操作，如發送郵件、閱讀收件箱、處理附件等，無需用戶手動輸入覆雜的API調用或切換到郵件客戶端。

<details> <summary><b>支持的功能</b> (點擊展開)</summary>

郵件發送：普通文本郵件、HTML郵件、帶附件郵件、群發郵件
郵件接收與查詢：獲取文件夾列表、列出郵件、高級搜索、獲取郵件詳情
郵件管理：標記已讀/未讀、刪除郵件、移動郵件
附件管理：查看附件列表、下載附件、查看附件內容
聯系人管理：獲取聯系人列表、搜索聯系人 </details>

以下是 Mail MCP 工具的一些核心特點：

高級搜索功能：支持多文件夾、關鍵詞、日期範圍、發件人、收件人等覆雜條件搜索
智能聯系人管理：自動從郵件歷史中提取聯系人信息，包括聯系頻率分析
內容範圍控制：可以分段查看大型郵件，避免加載過多內容
多種郵件格式：支持純文本和HTML格式郵件的發送和顯示
附件處理能力：智能識別附件類型，支持文本、圖片等不同類型的附件預覽
安全可靠：本地處理所有郵件操作，不通過第三方服務器轉發敏感信息

通過簡單的自然語言指令，AI 可以幫助你完成上述所有操作，無需手動編寫API調用或在郵件客戶端中執行覆雜操作。 </details>

快速上手

0. 環境準備

<details> <summary>如果你之前沒有使用過 Node.js (點擊展開)</summary>

安裝 Node.js 和 npm
- 訪問 Node.js 官網
- 下載並安裝 LTS（長期支持）版本
- 安裝時選擇默認選項即可，安裝包會同時安裝 Node.js 和 npm
驗證安裝
- 安裝完成後，打開命令提示符（CMD）或 PowerShell
- 輸入以下命令確認安裝成功：
```
node --version
npm --version
```
- 如果顯示版本號，則表示安裝成功

</details>

1. 構建項目

npm install
npm run build

2. 啟動服務

1. SSE
node dist/sse-server.js --port 22102 --host localhost

2. Stdio
{
	"mcpServers": {
		"phison-mail-mcp": {
			"command": "node",
			"args": [
				"dist/index.js"
			],
			"env": {
				"SMTP_HOST": "mail.phison.com",
				"SMTP_PORT": "25",
				"SMTP_SECURE": "false",
				"SMTP_USER": "example@phison.com",
				"SMTP_PASS": "example",
				"SMTP_ALLOW_UNAUTHORIZED_CERT": "false",
				"IMAP_HOST": "mail.phison.com",
				"IMAP_PORT": "993",
				"IMAP_SECURE": "true",
				"IMAP_USER": "example@phison.com",
				"IMAP_PASS": "example",
				"DEFAULT_FROM_NAME": "example",
				"DEFAULT_FROM_EMAIL": "example@phison.com"
			}
		}
	}
}