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 文件。