Email MCP

🚀 通用メールボックスMCPサーバー

このプロジェクトは、Model Context Protocol (MCP)に基づいて構築された汎用的なMCPサーバーで、AIが簡単にメールボックスを管理できるようにします。MCP-XやClaude DesktopなどのMCPクライアントで使用できます。

🚀 クイックスタート

方法1：npmパッケージを直接使用する（推奨）

1. npmパッケージをインストールする

# グローバルインストール
npm install -g mcp-email

# またはローカルインストール
npm install mcp-email

2. MCPクライアントで設定する

MCP-Xの設定例：

{
  "mcpServers": {
    "universal-email": {
      "command": "npx",
      "args": ["mcp-email"],
      "env": {
        "EMAIL_USER": "your-email@domain.com",
        "EMAIL_PASSWORD": "your-password-or-auth-code",
        "EMAIL_TYPE": "auto"
      }
    }
  }
}

方法2：ソースコードからインストールする

1. プロジェクトをクローンする

git clone https://github.com/TimeCyber/email-mcp.git
cd email-mcp

2. 依存関係をインストールする

npm install

3. MCPクライアントを設定する（ソースコードからのインストール）

MCP-Xの設定：

{
  "mcpServers": {
    "universal-email": {
      "command": "node",
      "args": ["F:\\path\\to\\email-mcp\\index.js"],
      "env": {
        "EMAIL_USER": "your-email@domain.com",
        "EMAIL_PASSWORD": "your-password-or-auth-code",
        "EMAIL_TYPE": "auto"
      }
    }
  }
}

企業用メールの設定：

{
  "mcpServers": {
    "enterprise-email": {
      "command": "node",
      "args": ["F:\\path\\to\\email-mcp\\index.js"],
      "env": {
        "EMAIL_USER": "user@company.com",
        "EMAIL_PASSWORD": "your-enterprise-auth-code",
        "EMAIL_TYPE": "exmail"
      }
    }
  }
}

4. 設定をテストする

# メール設定が成功したかテストする
node test-auto-config.js

✨ 主な機能

• 📤 メール送信: HTMLと純テキスト形式のメールを送信できます。
• 👥 複数受信者: 複数の受信者、同報、秘匿同報に対応しています。
• 📎 添付ファイル対応: ファイル添付とBase64エンコードされた内容をサポートします。
• 🔧 動的設定: 実行時にメールサーバーを設定できます。
• 🔍 接続テスト: 組み込みのSMTPサーバー接続テスト機能があります。
• 🛡️ セキュリティ認証: 微信企業用メールの認証コード認証に対応しています。
• ⚡ 高性能: 最適化された接続タイムアウトとリトライメカニズムがあります。

📦 インストール

# npmインストール
npm install -g mcp-email

# npxを使用して実行（推奨）
npx mcp-email

💻 使用例

基本的な使用法

{
  "to": ["recipient@example.com"],
  "subject": "テストメール",
  "text": "これはテストメールです"
}

高度な使用法

{
  "to": ["recipient1@example.com", "recipient2@example.com"],
  "cc": ["manager@example.com"],
  "subject": "プロジェクトレポート",
  "text": "プロジェクトレポートをご覧ください",
  "html": "<h1>プロジェクトレポート</h1><p>プロジェクトは順調に進んでいます。</p>"
}

📚 ドキュメント

プロジェクトには、主要なメールサービスプロバイダーの設定説明を含む詳細な設定ガイドが用意されています。

📖 CONFIG_GUIDE.md - 完全な設定ガイドで、以下の内容が含まれています。

• 📧 163メールの詳細な設定チュートリアル
• 🏢 微信企業用メールの設定ガイド
• 🌐 QQメール、Gmailなどの主要なメールの設定
• 🛠️ トラブルシューティングと一般的な問題の解決策

🔧 技術詳細

MCPツールの説明

1. send_email - メールを送信する

メールを送信し、さまざまな形式と受信者に対応しています。

2. get_recent_emails - 最近のメールを取得する

最近数日間のメールリストを取得し、最適なプロトコル（IMAP/POP3）を自動的に選択します。

3. get_email_content - メールの内容を取得する

指定されたメールの詳細な内容を取得します。

4. setup_email_account - メールアカウントを設定する

メールタイプを自動的に識別し、サーバーを設定します。8つの主要なメールサービスプロバイダーに対応しています。

5. list_supported_providers - サポートされているメールをリストする

サポートされているすべてのメールサービスプロバイダーとその設定情報を表示します。

6. configure_email_server - サーバーを手動で設定する

メールサーバーの設定を手動で行います（上級ユーザー向け）。

7. test_email_connection - 接続をテストする

メールサーバーの接続状態をテストします。

サポートされているメールサービスプロバイダー

主要なメールサーバーの設定

*网易メール（163/126/yeah）は、"Unsafe Login"エラーを回避するために自動的にPOP3プロトコルを使用します。

Gmailの特別な説明: 2025年5月1日から、Google Workspaceアカウントは"less secure apps"をサポートしなくなり、OAuth認証を使用する必要があります。個人のGmailはアプリ専用パスワードを使用する必要があります。詳細は設定ガイドを参照してください。*

自動設定機能

• ✅ スマート識別: メールドメインに基づいてサーバー設定を自動的に選択します。
• ✅ プロトコル最適化: 163メールは自動的にPOP3を使用し、その他のメールはIMAPを使用します。
• ✅ 企業用メール: EMAIL_TYPEフィールドを使用して手動で指定できます。
• ✅ エラー処理: IMAPが失敗した場合、自動的にPOP3プロトコルを試みます。

トラブルシューティング

一般的なエラーと解決策

• 535 Error: authentication failed
  • 原因: 認証に失敗しました。
  • 解決策:
    • メール設定でSMTP/IMAP/POP3サービスが有効になっていることを確認してください。
    • 認証コードまたはアプリ専用パスワードを再生成してください。
    • メールアドレスと認証コードが正しいことを確認してください。
    • 企業用メールの場合、管理者がサードパーティのアクセスを許可していることを確認してください。
• [IMAP] EXAMINE Unsafe Login (网易メールでよく見られる)
  • 原因: 网易メールのセキュリティ制限です。
  • 解決策:
    • システムが自動的にPOP3プロトコルに切り替えます。
    • 网易メールでPOP3/SMTPサービスが有効になっていることを確認してください。
    • 最新の16桁の認証コードを使用してください。
• ECONNREFUSED または接続タイムアウト
  • 原因: ネットワーク接続の問題です。
  • 解決策:
    • ネットワーク接続状態を確認してください。
    • ファイアウォールがメールポート (25, 465, 587, 993, 995) をブロックしていないことを確認してください。
    • 異なるネットワーク環境またはVPNを試してみてください。
• EMAIL_TYPE 関連のエラー
  • 原因: 企業用メールのドメインとサーバーが一致していません。
  • 解決策:
    • 企業用メールに正しい EMAIL_TYPE フィールドを設定してください。
    • 腾讯企業用メールは "exmail" に設定してください。
    • 网易企業用メールは "netease-enterprise" に設定してください。

診断ツール

組み込みの診断コマンドを使用します。

# メール設定をテストする
node test-auto-config.js

# EMAIL_TYPE機能をテストする
node test-email-type.js

# MCPツールを使用して接続をテストする
# MCPクライアントで test_email_connection を呼び出す

デバッグテクニック

1. 詳細なログを確認する: システムは自動的に設定と接続情報を出力します。
2. テストツールを使用する: test_email_connection で問題を診断します。
3. メールタイプを確認する: list_supported_providers でサポートされていることを確認します。
4. 段階的に設定する: まず setup_email_account で自動設定を行います。

プロジェクト構造

├── index.js                     # MCPサーバーのメインプログラム
├── package.json                # プロジェクトの依存関係設定
├── README.md                   # プロジェクトのメインドキュメント
├── CONFIG_GUIDE.md            # 詳細な設定ガイド
├── .gitignore                 # Gitが無視するファイル
├── 📁 設定模板/
│   ├── mcp-x_config_v2.json      # 汎用設定テンプレート
│   └── mcp-x_config_multi.json   # 複数アカウントの設定
├── 📁 テストツール/
│   ├── test-auto-config.js       # 自動設定のテスト
│   └── test-email-type.js        # EMAIL_TYPE機能のテスト
└── LICENSE                     # オープンソースライセンス

核心ファイルの説明

• index.js - 主要なMCPサーバープログラムで、すべてのメール機能を含んでいます。
• CONFIG_GUIDE.md - 詳細な設定ガイドで、さまざまなメール設定の説明が含まれています。
• mcp-x_config_v2.json - 汎用設定テンプレートで、EMAIL_TYPEフィールドをサポートしています。
• test-auto-config.js - 自動設定機能をテストするスクリプトです。
• test-email-type.js - EMAIL_TYPEフィールドの機能を検証するテストスクリプトです。

🔐 セキュリティに関する注意事項

1. 認証コードを保護する: 認証コードをバージョン管理システムに提出しないでください。
2. 環境変数を使用する: 機密情報を環境変数に保存することをお勧めします。
3. 定期的に更新する: 認証コードを定期的に更新し、セキュリティ設定を確認してください。
4. 権限管理を行う: MCPサーバーにアクセスできるのは承認されたユーザーのみにするようにしてください。

📞 技術サポート

ドキュメントリソース

• 📋 CONFIG_GUIDE.md - 完全な設定ガイド
• 🔧 テストツール - test-auto-config.js と test-email-type.js を使用します。
• 🛠️ 組み込み診断 - test_email_connection ツールを使用します。

公式ドキュメント

• 网易メールクライアントの設定
• 腾讯企業用メールの設定
• QQメールのヘルプセンター
• Gmailの設定ガイド

貢献ガイド

このプロジェクトを改善するために、IssueとPull Requestの提出を歓迎します！

• 🐛 バグ報告: 問題と再現手順を詳細に説明してください。
• 💡 機能提案: 新しいメールサポートの要求を歓迎します。
• 📝 ドキュメントの改善: 使用ドキュメントの充実にご協力ください。

プロジェクトの状態

• ✅ 本番環境で使用可能: 8つの主要なメールサービスプロバイダーをサポートしています。
• 🔄 継続的な更新: ユーザーのフィードバックに基づいて不断に改善しています。
• 🛡️ セキュリティ保障: SSL/TLS暗号化と認証コード認証をサポートしています。

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

🎉 クイックテスト

設定が完了したら、MCPクライアントで機能をテストできます。

テストメールを送信する：

test@example.comにテストメールを送信し、件名を"MCPテストメール"、内容を"Hello from Universal Email MCP!"としてください。

メールリストを取得する：

最近3日間のメールリストを取得し、メールを10件に制限してください。

接続をテストする：

メール接続状態をテストしてください。

すべての設定が正しければ、すべての機能が正常に動作するはずです！🚀