{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wet8hnyyxszb","handle":"netease163-mail-mcp","url":"https://wellknown.network/agents/netease163-mail-mcp","links":{"self":"https://wellknown.network/agents/netease163-mail-mcp/record.json","html":"https://wellknown.network/agents/netease163-mail-mcp","markdown":"https://wellknown.network/agents/netease163-mail-mcp/record.md","api":"https://wellknown.network/api/v1/agents/netease163-mail-mcp","status":"https://wellknown.network/api/v1/agents/netease163-mail-mcp/status","claim":"https://wellknown.network/agents/netease163-mail-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/netease163-mail-mcp/claim.json","badge":"https://wellknown.network/agents/netease163-mail-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/netease163-mail-mcp/history","tools":"https://wellknown.network/api/v1/agents/netease163-mail-mcp/tools"},"ard":{"identifier":"urn:air::server:netease163-mail-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"netease163-mail-mcp","summary":"NetEase Mail (163/126/yeah/qiye) MCP Server for WorkBuddy and other MCP clients","description":"# 网易邮箱 MCP 连接器（Netease Mail MCP Server） \n \n一个基于**官方 MCP SDK** 的**标准 MCP Server（stdio 传输）**，让 WorkBuddy / Claude 等 \nAI 客户端可以直接读写你的网易邮箱（163 / 126 / yeah / 企业邮）。 \n \n功能范围：**读写为基础** —— 浏览文件夹与邮件列表、搜索、读正文、下载附件、发送邮件、批量标记已读。 \n \n- 语言 / 运行时：**Python 3.10+**（开发环境为 3.13，Windows） \n- 传输协议：**stdio** \n- 唯一必需依赖：**`mcp`**（邮件协议只用标准库 `imaplib` / `smtplib` / `email` / `ssl`） \n \n--- \n \n## 1. 快速开始 \n \n### 1.1 安装依赖 \n \n```bash \ncd netease-mail-mcp \npython -m pip install -r requirements.txt \n``` \n \n> `python-dotenv` 为可选项：未安装时程序会自动跳过 `.env` 加载，不影响运行。 \n> \n> ⚠️ **MCP SDK 版本必须为 1.x（`mcp>=1.2.0,<2`）**：`mcp` 2.x 已移除 \n> `mcp.server.fastmcp`（`FastMCP` 更名为 `MCPServer`），本项目基于 1.x 的 FastMCP API 实现。 \n> `requirements.txt` 已锁定上界；若被其它依赖升级到 2.x，`server.py` 会在 import 阶段报 \n> `ModuleNotFoundError: No module named 'mcp.server.fastmcp'`，请执行 \n> `python -m pip install \"mcp>=1.2.0,<2\"` 降级。 \n \n### 1.2 获取客户端授权码（关键） \n \n网易邮箱必须使用**客户端授权码**（不是登录密码）作为认证凭据。请先在网页版邮箱开启 \nIMAP / SMTP 服务并生成授权码： \n \n**个人邮箱（163 / 126 / yeah）** \n1. 登录网页版邮箱（如 <https://mail.163.com>） \n2. 进入 **设置 → POP3/SMTP/IMAP** \n3. 开启 **IMAP/SMTP 服务** \n4. 按提示生成 **16 位客户端授权码**（请妥善保存，仅显示一次） \n \n**企业邮箱（qiye.163.com）** \n1. 登录企业邮箱网页版 \n2. 进入 **设置 → 账户与安全 → 客户端设置** \n3. 开启 IMAP / SMTP 服务并生成授权码 \n \n### 1.3 配置环境变量 \n \n复制样例文件并填写： \n \n```bash \ncp .env.example .env \n``` \n \n编辑 `.env`： \n \n```ini \nNETEASE_EMAIL=yourname@163.com \nNETEASE_AUTH_CODE=abcdnfghijklmnop \nNETEASE_MAIL_TYPE=163 \n``` \n \n也可以在 MCP 客户端配置里用 `env` 直接注入（推荐，见下一节）。 \n \n### 1.4 连通性自检（可选但推荐） \n \n```bash \npython scripts/smoke_test.py \n# 如需顺带验证发信： \nNETEASE_SMOKE_TO=yourname@163.com python scripts/smoke_test.py \n``` \n \n--- \n \n## 2. 在 MCP 客户端中配置 \n \n### WorkBuddy / Claude Desktop（`mcp.json`） \n \n```json \n{ \n  \"mcpServers\": { \n    \"netease-mail\": { \n      \"command\": \"python\", \n      \"args\": [ \n        \"C:\\\\Users\\\\MECHREU\\\\WorkBuddy\\\\2026-09-23-10-21-00\\\\netease-mail-mcp\\\\server.py\" \n      ], \n      \"env\": { \n        \"NETEASE_EMAIL\": \"yourname@163.com\", \n        \"NETEASE_AUTH_CODE\": \"abcdnfghijklmnop\", \n        \"NETEASE_MAIL_TYPE\"…","publisher":{"name":"李洋万鲲","url":null},"homepage":null,"repository":null,"version":"1.0.0","license":null,"protocols":["mcp"],"tags":["mcp","netease","mail","163","imap","smtp"],"pricing":null,"endpoints":[{"url":"pypi:netease163-mail-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.email","name":"Email","confidence":1,"provenance":"declared"}],"categories":["productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"netease163-mail-mcp","registry":"pypi","observedAt":"2026-11-05T22:26:24.748Z","publishedAt":"2026-09-23T06:44:24.039091Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"netease163-mail-mcp","url":"https://pypi.org/project/netease163-mail-mcp/","firstSeenAt":"2026-09-24T10:27:56.908Z","fetchedAt":"2026-11-05T22:24:49.578Z","normalizedAt":"2026-11-05T22:24:49.578Z"}]},"firstSeenAt":"2026-09-24T10:27:56.908Z","updatedAt":"2026-11-05T22:26:24.748Z"}