Migadu MCP

🚀 Migadu MCP 服務器

Migadu MCP 服務器允許通過模型上下文協議（MCP），藉助 AI 助手來控制你的 Migadu 電子郵件託管服務，為郵件管理帶來更智能、便捷的體驗。

🚀 快速開始

配置

將以下內容添加到你的 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 設置自動回覆"

✨ 主要特性

• 智能管理：無需手動操作網頁界面，可通過 AI 助手完成郵箱的創建、刪除、別名設置、轉發規則配置等操作。
• 批量處理：支持高效的批量操作，提升管理效率。
• 多功能工具：提供郵箱管理、郵件路由、身份管理、高級路由和外部轉發等多種工具。
• 結構化數據訪問：通過資源 URI 訪問結構化數據，方便快捷。

📦 安裝指南

克隆倉庫

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"

📚 詳細文檔

可用工具

郵箱管理

• 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 - 域名的重寫規則

🔧 技術細節

• 自動處理 API 特性：服務器會自動處理 Migadu API 的一些特殊情況（例如成功刪除操作返回 500 狀態碼）。
• 錯誤處理與進度報告：所有操作都包含適當的錯誤處理和進度報告。
• 可靠集成：基於 FastMCP 構建，確保可靠的 MCP 集成。
• 批量操作優化：支持批量操作，並採用智能批處理方式。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。