Mail

🚀 メール送信MCP使用説明

このプロジェクトは、メール送信のためのMCP（Mail Communication Protocol）を使用する方法を提供します。以下に、MCPの設定、起動、使用方法について詳しく説明します。

🚀 クイックスタート

設定ガイド

Windowsシステム設定

1. Cursorエディタを開き、mcp.jsonファイルを探すか作成します。パスは C:\Users\你的用户名\.cursor\mcp.json です。
2. 以下の内容をファイルに追加または修正します。

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "C:\\Users\\你的用户名\\mcp-mail\\bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ 重要提示

• 你的用户名 を実際のWindowsユーザー名に置き換えてください。
• パスがプロジェクトファイルの実際の位置を正しく指していることを確認してください。
• プロジェクトフォルダを削除または移動しないでください。

macOSシステム設定

1. ターミナルを開き、cd ~ && ls -a コマンドを実行して隠しディレクトリを表示します。
2. ~/.cursor/ ディレクトリで mcp.json ファイルを作成または編集します。
3. 以下の内容をファイルに追加します。

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "/Users/你的用户名/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ 重要提示

• 你的用户名 を実際のmacOSユーザー名に置き換えてください。
• パスがプロジェクトファイルの実際の位置を正しく指していることを確認してください。
• プロジェクトフォルダを削除または移動しないでください。

Linuxシステム設定

1. ターミナルを開き、cd ~ && ls -a コマンドを実行して隠しディレクトリを表示します。
2. ~/.cursor/ ディレクトリで mcp.json ファイルを作成または編集します。
3. 以下の内容をファイルに追加します。

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "/home/你的用户名/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ 重要提示

• 你的用户名 を実際のLinuxユーザー名に置き換えてください。
• パスがプロジェクトファイルの実際の位置を正しく指していることを確認してください。
• プロジェクトフォルダを削除または移動しないでください。

サービスの起動

1. ターミナルを開き、以下のコマンドを実行してMCPサービスを起動します。

   npm start mcp
   

2. コンソール出力を確認し、サービスが正常に起動したことを確認します。

💻 使用例

基本的な使用法

const mcp = require('mcp');

// 通常のメールを送信
mcp.sendEmail({
    from: 'your.email@example.com',
    to: 'recipient@example.com',
    subject: 'テストメール',
    text: 'これはテストメールです'
}).then(() => {
    console.log('メール送信成功');
}).catch(error => {
    console.error('送信失敗:', error);
});

// 添付ファイル付きのメールを送信
mcp.sendEmail({
    from: 'your.email@example.com',
    to: 'recipient@example.com',
    subject: '添付ファイル付きのテストメール',
    text: '添付ファイルをご確認ください',
    attachments: [
        {
            filename: 'test.txt',
            content: 'これは添付ファイルの内容です'
        }
    ]
}).then(() => {
    console.log('メール送信成功');
}).catch(error => {
    console.error('送信失敗:', error);
});

📚 ドキュメント

メール送信フロー

1. MCPサービスの初期化：SMTPとIMAPのパラメータを設定し、メールサーバーとの接続を確立します。
2. メール内容の作成：送信者、受信者、件名、本文などの情報を含みます。
3. 添付ファイルの追加（オプション）：ファイルをメールに添付します。
4. メールの送信：SMTPプロトコルを使用してメールを宛先メールボックスに送信します。

技術的な実装

• nodeMailer ライブラリを使用してSMTP通信を処理します。
• mailクライアントライブラリ を使用してIMAP操作を処理します。
• 添付ファイルの処理と複数のメール形式をサポートします。
• エラー処理とログ記録機能を提供します。

🔧 技術詳細

依存関係

nodeMailer と mailクライアントライブラリ をインストールする必要があります。

環境変数

SMTPとIMAPの情報は環境変数を通じて設定されます。

📄 ライセンス

このプロジェクトはMITライセンスに準拠しており、自由に使用および修正することができます。

何か問題があれば、技術サポートにご連絡ください。