mcp_email_reader について
mcp_email_readerは、対応するAIツールからメールを扱うためのMCPサーバーです。メール検索、添付ファイルのダウンロード、フォルダー一覧の取得を行えます。
主な機能
- 01メール検索
- 02添付ファイルのダウンロード
- 03フォルダー一覧の取得
活用シーン
- 01条件に合うメールの検索
- 02メール添付ファイルの取得
- 03メールフォルダーの確認
MCP 対応
MCPクライアント向けに、メール検索、添付ファイルのダウンロード、フォルダー一覧取得のツールを提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
mcp_email_reader
Model Context Protocol(MCP)サーバーは、search_emails、download_attachment、list_folders という複数の MCP ツールを提供します。Claude Desktop と Ollama を使用した LibreChat でテスト済みです。
インストール
前提条件
Windows
-
Claude Desktop(またはその他の MCP 対応 AI ツール)をインストールします
- Claude for Desktop をダウンロードします
- 最新のインストール手順に従います:Installing Claude Desktop
-
Python 3.10 以降をインストールします:
- 最新の Python インストーラーを python.org からダウンロードします
- インストーラーを実行し、「Add Python to PATH」にチェックを入れます
- コマンドプロンプトを開き、
python --versionでインストールを確認します
-
uv をインストールします:
- 管理者としてコマンドプロンプトを開きます
pip install --user uvを実行しますuv --versionでインストールを確認します
macOS
-
Claude Desktop(またはその他の MCP 対応 AI ツール)をインストールします
- Claude for Desktop をダウンロードします
- 最新のインストール手順に従います:Installing Claude Desktop
-
Python 3.10 以降をインストールします:
- Homebrew を使用する場合:
brew install python python3 --versionでインストールを確認します
- Homebrew を使用する場合:
-
uv をインストールします:
- Homebrew を使用する場合:
brew install uv - または、
pip3 install --user uv uv --versionでインストールを確認します
- Homebrew を使用する場合:
設定
以下を claude_desktop_config.json に追加します:
{
"mcpServers": {
"mcp_email_reader": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/karateboss/mcp_email_reader@main",
"mcp_email_reader"
],
"env": {
"IMAP_SERVER": "<email server>",
"EMAIL_ACCOUNT": "<user email account>",
"EMAIL_PASSWORD_ENC": "<encrypted password>"
"EMAIL_SECRET_KEY": "<secret key used to encypt password>"
}
}
}
注:秘密鍵を使用して暗号化されたパスワードを復号できることは明らかであり、潜在的なセキュリティリスクとなります。ただし、claude_desktop_config.json はお使いのノートパソコン/PCにローカル保存されています。uvx を使用してリポジトリを動的にクローンする場合、.env ファイルを追加できないため、上記の JSON ファイルに追加しています。
クレジット
このソフトウェアパッケージは、MCP 対応フレームワークでメールを読み取る機能を実装したもので、karateboss によって開発されています。
貢献
これらのツールの改善に向けた貢献を歓迎します。リポジトリから issue とプルリクエストを送信してください。
サポート
質問やサポートについては、以下をご覧ください:
- ドキュメントを確認します
- リポジトリで issue を送信します
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。