@emailalias/mcp

用于 EmailAlias.io REST API 的 MCP 服务器。让你能够通过自然语言在 Claude Desktop、Cursor、Zed、Cline 以及任何其他兼容 MCP 的 AI 助手上创建、管理和监控电子邮件别名。

“为 Substack 创建一个新别名，标签设为 'newsletter'” “禁用 amazon 别名，我收到垃圾邮件了” “显示本周被标记为可疑发件人的别名”

API 访问是高级 (Premium) 功能。请从仪表板的 Settings → API Keys 生成 API 密钥。

安装

Claude Desktop

编辑你的配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

在 mcpServers 下添加 emailalias 条目：

{
  "mcpServers": {
    "emailalias": {
      "command": "npx",
      "args": ["-y", "@emailalias/mcp"],
      "env": {
        "EMAILALIAS_API_KEY": "ea_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

重启 Claude Desktop。你应该能看到一个 🔌 插头图标，确认服务器已连接。

Cursor、Zed、Cline 及其他 MCP 客户端

每个兼容 MCP 的客户端都接受相同的配置格式。请查阅你所用客户端的文档以获取确切的配置路径，然后使用：

command: npx
args: -y @emailalias/mcp
env: EMAILALIAS_API_KEY=ea_live_...

全局安装（可选）

如果你不希望 npx 在每次启动时都下载该包：

npm install -g @emailalias/mcp

然后将 command 改为 emailalias-mcp 并去掉 -y @emailalias/mcp 参数。

Related MCP server: Inbound Email MCP Server

配置

可用工具

示例提示词 (Claude Desktop)

Create a disposable alias for signing up to Substack. Label it "newsletter".

Show me all aliases that have received zero emails in 30 days.

Disable every alias labelled "shopping" and list what you disabled.

What's my exposure alert count for this month?

开发

git clone https://github.com/emailalias/emailalias-mcp.git
cd emailalias-mcp
npm install
npm run build

# Test against the MCP Inspector (installs on demand)
npx @modelcontextprotocol/inspector node dist/index.js

手动运行时必须在 shell 中设置 EMAILALIAS_API_KEY。

安全说明

• 你的 API 密钥保留在本地机器上。 此服务器在本地运行（stdio 传输），通过 HTTPS 调用 EmailAlias API，并直接发送密钥。没有第三方能看到它。

• 不要提交 claude_desktop_config.json — 它包含你的密钥。请像对待 .env 文件一样对待它。

• 作用域很重要。 你的 LLM 决定调用的任何 MCP 工具都会针对你的实时账户执行。在批准像 delete_alias 这样具有破坏性的操作之前，请务必审查模型提出的建议。

链接

• API 文档: https://emailalias.io/documentation

• EmailAlias.io: https://emailalias.io

• 模型上下文协议 (Model Context Protocol): https://modelcontextprotocol.io

许可证

MIT