Migadu MCP

🚀 Migadu MCP 服务器

Migadu MCP 服务器允许你通过模型上下文协议（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"
      }
    }
  }
}

获取 API 密钥

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

示例用法

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

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

✨ 主要特性

本 MCP 服务器让 AI 助手能够管理你的 Migadu 电子邮件账户，你无需再通过网页界面进行操作，AI 可以：

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

📦 安装指南

# 克隆仓库
git clone https://github.com/Michaelzag/migadu-mcp.git
cd migadu-mcp

# 安装依赖
uv sync --group dev

# 运行测试
uv run pytest

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

💻 使用示例

基础用法

配置好后，你可以向 AI 助手提出各种邮箱管理请求，例如创建新邮箱：

"Create a new mailbox for john@mydomain.com with the name John Smith"

高级用法

还可以进行批量操作，比如批量删除邮箱：

"Delete the mailboxes for employees who left: alice@mydomain.com, bob@mydomain.com"

📚 详细文档

Migadu 是什么？

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

可用工具

邮箱管理

• 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 集成。
• 支持批量操作，并具备智能分批功能。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。