Migadu MCP

🚀 Migadu MCP Server

このプロジェクトは、Model Context Protocol (MCP) を使用して、AIアシスタントを通じてMigaduのメールホスティングを管理できるようにするサーバーです。Migaduのメールアカウントを、Webインターフェイスを使わずにAIに指示することで管理できます。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントがMigaduのメールアカウントを管理できるようになります。Webインターフェイスを操作する代わりに、AIに以下のようなことを依頼できます。

• メールボックスの作成と削除
• メールエイリアスと転送ルールの設定
• 自動返信の設定
• 複数のメールIDの管理
• 一括操作の効率的な処理

✨ 主な機能

メールボックス管理

• 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クライアントの設定（例：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アシスタントに以下のようなことを依頼できます。

- "john@mydomain.com の新しいメールボックスを John Smith という名前で作成して"
- "自分のドメインのすべてのメールボックスを一覧表示して"
- "support@mydomain.com のメールエイリアスを作成し、team@mydomain.com に転送するように設定して"
- "退職した社員のメールボックス alice@mydomain.com と bob@mydomain.com を削除して"
- "vacation@mydomain.com の自動返信を設定して"

📚 ドキュメント

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 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 ファイルを参照してください。