Migadu MCP 服务器

通过使用模型上下文协议（MCP）的AI助手来控制你的Migadu邮件托管服务。

Migadu 是什么？

Migadu 是一家瑞士的电子邮件托管服务提供商，提供无限数量的电子邮件地址，并根据实际使用情况而非邮箱数量进行定价。他们专注于标准的电子邮件协议（SMTP/IMAP/POP3），没有供应商锁定，因此深受开发者和注重隐私用户的欢迎。

这个工具的作用是什么？

这个MCP服务器让AI助手能够管理你的Migadu电子邮件账户。你可以要求你的AI助手执行以下操作，而无需通过网页界面点击：

• 创建和删除邮箱
• 设置电子邮件别名和转发规则
• 配置自动回复
• 管理多个电子邮件身份
• 高效处理批量操作

安装

在你的MCP客户端配置中添加如下内容（例如，在Claude Desktop中）：

{
  "mcpServers": {
    "migadu": {
      "command": "uvx",
      "args": ["migadu-mcp"],
      "env": {
        "MIGADU_EMAIL": "admin@yourdomain.com",
        "MIGADU_API_KEY": "your-api-key",
        "MIGADU_DOMAIN": "yourdomain.com"
      }
    }
  }
}

从 Migadu 管理 > 我的账户 > API 密钥 获取你的API密钥。

示例用法

一旦配置完成，你可以向你的AI助手提出如下请求：

• "为john@mydomain.com创建一个名为John Smith的新邮箱"
• "列出我域下的所有邮箱"
• "设置电子邮件别名support@mydomain.com，将其转发到team@mydomain.com"
• "删除已离职员工的邮箱：alice@mydomain.com, bob@mydomain.com"
• "为vacation@mydomain.com创建一个自动回复"

可用工具

邮箱管理

• list_mailboxes / list_my_mailboxes - 查看所有邮箱
• get_mailbox / get_my_mailbox - 获取邮箱详情
• create_mailbox / create_my_mailbox - 创建新邮箱
• update_mailbox - 更改邮箱设置
• delete_mailbox - 删除邮箱
• bulk_delete_mailboxes - 批量删除多个邮箱
• reset_mailbox_password - 更改密码
• set_autoresponder - 配置离线消息

邮件路由

• list_aliases / list_my_aliases - 查看电子邮件别名
• create_alias - 设置电子邮件转发，无需创建邮箱
• update_alias - 更改别名目标
• delete_alias - 删除别名

身份管理

• list_identities - 查看发送地址
• create_identity - 添加额外的发送地址
• update_identity - 修改身份权限
• delete_identity - 删除身份

高级路由

• list_rewrites - 查看基于模式的路由规则
• create_rewrite - 设置通配符电子邮件路由
• update_rewrite - 修改路由模式
• delete_rewrite - 删除路由规则

外部转发

• list_forwardings - 查看外部转发规则
• create_forwarding - 将电子邮件转发到外部地址
• update_forwarding - 更改转发设置
• delete_forwarding - 删除转发规则

MCP 资源

通过这些资源URI访问结构化数据：

• mailboxes://domain.com - 域的所有邮箱
• mailbox://domain.com/username - 具体邮箱的详细信息
• aliases://domain.com - 域的所有别名
• identities://domain.com/mailbox - 邮箱的身份
• forwardings://domain.com/mailbox - 邮箱的转发规则
• rewrites://domain.com - 域的重写规则

技术说明

• 该服务器会自动处理Migadu API的一些特殊问题（如成功删除时返回500状态码）
• 所有操作都包含适当的错误处理和进度报告
• 使用FastMCP构建，以实现可靠的MCP集成
• 支持智能批处理的批量操作

开发

# 克隆仓库
git clone https://github.com/Michaelzag/migadu-mcp.git
cd migad
uv sync --group dev

# 运行测试
uv run pytest

# 运行质量检查
uv run ruff format --check .
uv run ruff check .
uv run mypy migadu_mcp/

许可证

MIT 许可证 - 详情见LICENSE文件。