Information
AgentMail MCP 集成
一个简单的模型上下文协议 (MCP) 服务器，与 AgentMail 集成，通过 AI 助手（如 Claude）动态管理邮箱、列出邮件、发送或回复电子邮件。此参考实现演示了如何在 MCP 服务器中使用 AgentMail 的 API 来即时编排邮箱。
关于 AgentMail
AgentMail 是一个以 API 为先的电子邮件提供商，允许 AI 代理即时创建邮箱以发送、接收和处理电子邮件。我们在电子邮件层之上构建了多层智能，优化了代理工作流程，并使数据能够被大语言模型消化。请在此处请求 API 密钥 这里！
重要提示
这是一个正在进行中的包，因为 MCP 协议仍在不断发展中。一旦添加新功能，我们将立即更新。加入我们的 Discord 社区！Discord
特性
动态创建新邮箱
列出并检索邮箱 以查看哪些是活跃的
从您的任何 AgentMail 邮箱发送电子邮件
在现有线程中回复消息
列出所选邮箱的线程和消息
检索消息附件
前提条件
Python 3.10+
AgentMail API 密钥
（可选）Claude Desktop 或支持 MCP 命令的任何其他前端
安装
该项目存在一个 PyPi 包。安装后，您可以在 Claude Desktop 配置中引用它（或直接运行），以启用电子邮件管理工具。
PIP（本地或 PyPI）
如果您维护自己的 Python 环境，只需从虚拟环境中安装该包（从 PyPI 或本地源）：
pip install agentmail-mcp
然后运行：
agentmail-mcp --api-key="YOUR_AGENTMAIL_API_KEY"
这将使服务器在您的本地机器上运行。
选项 1：使用 Claude Desktop
如果您想从 Claude Desktop 与服务器交互，请按照以下步骤操作。
激活您的虚拟环境。
source .venv/bin/activate
运行下面的命令以查找 Agentmail MCP 服务器包的位置。如果在虚拟环境中安装了 agentmail-mcp 包，它应该位于某个 .venv/bin/ 目录中。对于 Claude Desktop，重要的是您需要在虚拟环境中安装它。
which agentmail-mcp
复制返回的路径。
将路径粘贴到 claude_desktop_config.json 文件中的 command 字段中。
重启 Claude Desktop。
以下是 claude_desktop_config.json 文件应具有的样子：
\{
"mcpServers": \{
"agentmail-mcp": \{
"command": "/path/to/agentmail-mcp",
"args": ["--api-key", "\{AGENT_MAIL_API_KEY\}"]
\}
\}
\}
如果您没有 claude_desktop_config.json 文件，请在以下目录中创建一个：
在 macOS 上，配置文件通常位于：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上，通常位于：%APPDATA%/Claude/claude_desktop_config.json
保存后，重启 Claude Desktop 以加载新的 MCP 服务器。
使用方法
在Claude Desktop（或其他MCP客户端）中运行您的服务器后，您可以使用自然语言命令来指示Claude执行与AgentMail MCP工具相对应的操作。例如：
“创建一个名为demo的新收件箱。”
“列出我所有的收件箱。”
“从收件箱test@agentmail.to向test@example.com发送一封主题为‘Hello’的邮件，并在正文中解释过去一周旧金山的天气情况。”
“回复收件箱abc123中的最新消息。”
内部实现上，Claude会调用暴露出来的MCP工具（如create_inbox, list_inboxes, send_message等），这些工具再进一步调用AgentMail API。
许可证
许可证
MIT许可证 - 本项目按照MIT许可证分发。使用风险自负。
⸻