MCP Email Server

MCP Email Server

メール機能を提供する Model Context Protocol サーバーです。このサーバーを使用すると、LLM がメールを作成して送信したり、指定したディレクトリ内の添付ファイルを検索したりできます。

機能

• 複数の宛先へのメール送信
• メール添付ファイルのサポート
• パターンマッチングによるディレクトリ内のファイル検索
• SMTP を使用した安全なメール送信

利用可能なツール

• send_email - 指定された件名、本文、宛先に基づいてメールを送信します。

  • receiver（文字列の配列、必須）：宛先メールアドレスのリスト
  • body（文字列、必須）：メールの本文
  • subject（文字列、必須）：メールの件名
  • attachments（文字列の配列または文字列、任意）：メールの添付ファイル（ファイル名）

• search_attachments - 指定したディレクトリ内で、指定したパターンに一致するファイルを検索します。

  • pattern（文字列、必須）：ファイル名で検索するテキストパターン

プロンプト

• send_email

  • 添付ファイルを付けてメールを送信します（添付ファイルは任意です）
  • 引数：
    • receiver（必須）：宛先メールアドレスのリスト
    • body（必須）：メールの本文
    • subject（必須）：メールの件名
    • attachments（任意）：メールの添付ファイル

• search_attachments

  • パターンに一致するファイルを検索します
  • 引数：
    • pattern（必須）：ファイル名で検索するテキストパターン

インストール

pip を使用する場合

必要な依存関係をインストールします：

pip install pydantic python-dotenv

メールの設定

SMTP サーバーの設定を記述した email.json ファイル：

[
  {
    "domain": "@gmail.com",
    "server": "smtp.gmail.com", 
    "port": 587
  },
  {
    "domain": "@outlook.com",
    "server": "smtp.office365.com",
    "port": 587
  },
  {
    "domain": "@yahoo.com",
    "server": "smtp.mail.yahoo.com",
    "port": 587
  }
]

使用方法

サーバーの起動

次のコマンドで MCP Email Server を起動します：

python -m mcp_email_server (--dir /path/to/attachment/directory)

Claude.app の設定

Claude の設定に追加します：

Conda

{
  "mcpServers": {
    "email": {
      "command": "D:\\conda\\envs\\mcp\\python.exe",
      "args": [
        "C:\\Users\\YourUserName\\Desktop\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "[email protected]",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

UV

{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": [
        "~\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "[email protected]",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

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

• Gmail などのサービスでは、アプリ専用パスワードが必要になる場合があります
• セキュリティ上の理由により、サーバーがサポートする添付ファイルの種類は限定されています

サポートされているファイル形式

サーバーは、次の種類のファイルを添付ファイルとしてサポートしています：

• ドキュメント：doc、docx、xls、xlsx、ppt、pptx、pdf
• アーカイブ：zip、rar、7z、tar、gz
• テキストファイル：txt、log、csv、json、xml
• 画像：jpg、jpeg、png、gif、bmp
• その他：md

使用例

メールの送信

{
  "receiver": ["[email protected]"],
  "subject": "Test Email from MCP Server",
  "body": "This is a test email sent via the MCP Email Server.",
  "attachments": ["document.pdf", "image.jpg"]
}

添付ファイルの検索

{
  "pattern": "report"
}

コントリビューション

MCP Email Server の拡張と改善に役立つコントリビューションを歓迎します。新しいツールの追加、既存機能の強化、ドキュメントの改善など、どのようなご協力も大切です。

ほかの MCP サーバーや実装パターンの例については、こちらをご覧ください： https://github.com/modelcontextprotocol/servers

プルリクエストを歓迎します！MCP Email Server をさらに強力で便利にするアイデア、バグ修正、機能強化をぜひお寄せください。

ライセンス

MCP Email Server は MIT License のもとでライセンスされています。MIT License の利用規約に従う限り、このソフトウェアを自由に使用、変更、配布できます。