Migadu MCP

🚀 Migadu MCP Server

このプロジェクトは、Model Context Protocol (MCP) を使用してAIアシスタント経由でMigaduのメールホスティングを管理できるようにします。

🚀 クイックスタート

Migadu MCP Serverを使用することで、AIアシスタントを通じてMigaduのメールアカウントを管理できます。Webインターフェースをクリックする代わりに、AIに様々な操作を依頼できます。

✨ 主な機能

• メールボックスの管理：メールボックスの作成、削除、設定変更などを行えます。
• メールエイリアスと転送ルールの設定：エイリアスの作成、転送先の変更、削除などが可能です。
• 自動返信設定：自動返信メッセージを設定できます。
• 複数のメールIDの管理：複数のメールIDを効率的に管理できます。
• 一括操作：複数のメールボックスやエイリアスを一度に操作できます。

📦 インストール

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 Admin > My Account > API Keys から取得できます。

💻 使用例

基本的な使用法

設定が完了したら、AIアシスタントに以下のような要求をすることができます。

- "Create a new mailbox for john@mydomain.com with the name John Smith"
- "List all mailboxes on my domain"
- "Set up an email alias support@mydomain.com that forwards to team@mydomain.com"
- "Delete the mailboxes for employees who left: alice@mydomain.com, bob@mydomain.com"
- "Create an autoresponder for 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ステータスコードが返るなど）を自動的に処理します。
• すべての操作には適切なエラーハンドリングと進捗報告が含まれています。
• 信頼性の高いMCP統合のためにFastMCPを使用して構築されています。
• インテリジェントなバッチ処理による一括操作をサポートしています。

🛠️ 開発

# リポジトリをクローン
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/

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。