netease163-mail-mcp

# 网易邮箱 MCP 连接器（Netease Mail MCP Server） 一个基于**官方 MCP SDK** 的**标准 MCP Server（stdio 传输）**，让 WorkBuddy / Claude 等 AI 客户端可以直接读写你的网易邮箱（163 / 126 / yeah / 企业邮）。 功能范围：**读写为基础** —— 浏览文件夹与邮件列表、搜索、读正文、下载附件、发送邮件、批量标记已读。 - 语言 / 运行时：**Python 3.10+**（开发环境为 3.13，Windows） - 传输协议：**stdio** - 唯一必需依赖：**`mcp`**（邮件协议只用标准库 `imaplib` / `smtplib` / `email` / `ssl`） --- ## 1. 快速开始 ### 1.1 安装依赖 ```bash cd netease-mail-mcp python -m pip install -r requirements.txt ``` > `python-dotenv` 为可选项：未安装时程序会自动跳过 `.env` 加载，不影响运行。 > > ⚠️ **MCP SDK 版本必须为 1.x（`mcp>=1.2.0,<2`）**：`mcp` 2.x 已移除 > `mcp.server.fastmcp`（`FastMCP` 更名为 `MCPServer`），本项目基于 1.x 的 FastMCP API 实现。 > `requirements.txt` 已锁定上界；若被其它依赖升级到 2.x，`server.py` 会在 import 阶段报 > `ModuleNotFoundError: No module named 'mcp.server.fastmcp'`，请执行 > `python -m pip install "mcp>=1.2.0,<2"` 降级。 ### 1.2 获取客户端授权码（关键） 网易邮箱必须使用**客户端授权码**（不是登录密码）作为认证凭据。请先在网页版邮箱开启 IMAP / SMTP 服务并生成授权码： **个人邮箱（163 / 126 / yeah）** 1. 登录网页版邮箱（如 <https://mail.163.com>） 2. 进入 **设置 → POP3/SMTP/IMAP** 3. 开启 **IMAP/SMTP 服务** 4. 按提示生成 **16 位客户端授权码**（请妥善保存，仅显示一次） **企业邮箱（qiye.163.com）** 1. 登录企业邮箱网页版 2. 进入 **设置 → 账户与安全 → 客户端设置** 3. 开启 IMAP / SMTP 服务并生成授权码 ### 1.3 配置环境变量 复制样例文件并填写： ```bash cp .env.example .env ``` 编辑 `.env`： ```ini [email protected] NETEASE_AUTH_CODE=abcdnfghijklmnop NETEASE_MAIL_TYPE=163 ``` 也可以在 MCP 客户端配置里用 `env` 直接注入（推荐，见下一节）。 ### 1.4 连通性自检（可选但推荐） ```bash python scripts/smoke_test.py # 如需顺带验证发信： [email protected] python scripts/smoke_test.py ``` --- ## 2. 在 MCP 客户端中配置 ### WorkBuddy / Claude Desktop（`mcp.json`） ```json { "mcpServers": { "netease-mail": { "command": "python", "args": [ "C:\\Users\\MECHREU\\WorkBuddy\\2026-09-23-10-21-00\\netease-mail-mcp\\server.py" ], "env": { "NETEASE_EMAIL": "[email protected]", "NETEASE_AUTH_CODE": "abcdnfghijklmnop", "NETEASE_MAIL_TYPE"…