AgentMail MCP 是 AgentMail 项目的官方 MCP 实现仓库，目标是为 AI 智能体提供电子邮件能力：按需创建收件箱，用于发送、接收邮件并基于邮件采取行动。
用途 该项目面向需要让 AI 智能体处理电子邮件的场景，由 AgentMail 托管服务器提供唯一的 MCP 工具实现。
主要能力与结构
- 托管 MCP 服务器：仓库中的 packages/server 是托管的 MCP 服务器，也是唯一的 AgentMail 工具实现。它使用 Streamable HTTP 端点，客户端在支持远程 MCP 时可直接连接该端点。该端点会提供当前运行时的工具目录，并支持托管服务器现有的 OAuth 和按请求 API 密钥两种认证路径。相关使用说明可参见 AgentMail MCP 文档。
- stdio 兼容桥接：为兼容仅支持 stdio 的客户端，仓库提供两种桥接。原有 Node 配置可通过 npm 桥接继续工作；Python 用户可运行等价的本地桥接。两种桥接都从托管服务器发现工具与架构，自身不包含 AgentMail SDK、工具包、REST API 或工具定义逻辑。
- 工具过滤：对于需要过滤工具目录的 stdio 客户端，仍可使用 --tools name1,name2 参数。
仓库内容
- packages/server：托管的 MCP 服务器，唯一 AgentMail 工具实现。
- packages/npm-stdio-bridge：npm 包 agentmail-mcp。
- python/stdio-bridge：PyPI 包 agentmail-mcp。
- mcp-manifest.json：生成的运行时契约。
- tests：契约与传输检查。
- docs：架构、兼容性、迁移、发布和运维文档。
兼容与迁移说明 旧的本地 npm 实现保留在 legacy-local-v0.2.2 分支。认证加固是另一个独立项目，本次整合保持托管服务器已有行为不变。
限制与暂未提供 资料未提供具体的安装命令、API 密钥获取方式、OAuth 配置细节、支持的客户端列表、收费方式、价格以及邮件发送与接收的功能上限等信息，暂未提供。
