IMAP MCP Server

IMAP MCP サーバー

AI アシスタントが電子メールをチェックし、メッセージを処理し、対話を通じてユーザーの好みを学習できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

概要

このプロジェクトは、IMAP 電子メール サーバーとインターフェイスして次の機能を提供する MCP サーバーを実装します。

• メールの閲覧と検索
• メールの整理（移動、タグ付け、マーク付け）
• メールの作成と返信
• インタラクティブな電子メール処理とユーザー設定の学習
• 自動メール要約と分類
• 複数のIMAPプロバイダーのサポート

IMAP MCP サーバーは、Claude やその他の MCP 互換アシスタントと連携するように設計されており、時間の経過とともにユーザーの好みを学習するインテリジェントな電子メール アシスタントとして機能します。

特徴

• メール認証: さまざまな認証方法による IMAP サーバーへの安全なアクセス
• メール閲覧: フィルタリングオプションを使用してフォルダとメッセージを一覧表示します
• メールの内容: テキスト、HTML、添付ファイルを含むメッセージの内容を読む
• メールアクション: 移動、削除、既読/未読としてマーク、メッセージにフラグを付ける
• メール作成: 適切な形式でメッセージへの返信を下書きして保存します
  • プレーンテキストとHTMLの返信をサポート
  • CC サポートによる全員返信機能
  • In-Reply-To と References ヘッダーを使用した適切なスレッド化
  • 下書きを適切なフォルダに保存する
• 検索: フォルダ間の基本的な検索機能
• インタラクションパターン：電子メールの処理と学習設定のための構造化パターン（計画中）
• 学習レイヤー: ユーザーの意思決定を記録・分析し、将来の行動を予測する（計画）

現在のプロジェクト構造

プロジェクトは現在、次のように構成されています。

はじめる

前提条件

• Python 3.8以上
• IMAP 対応のメールアカウント（Gmail を推奨）
• パッケージ管理とPythonスクリプトの実行のためのuv

インストール

1. まだインストールしていない場合は、uv をインストールします。
   curl -LsSf https://astral.sh/uv/install.sh | sh
2. パッケージをクローンしてインストールします。
   git clone https://github.com/non-dirty/imap-mcp.git cd imap-mcp uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e ".[dev]"

Gmailの設定

1. 設定ファイルを作成します。
   cp config.sample.yaml config.yaml
2. Gmail OAuth2 認証情報を設定します。
   • Google Cloud Consoleに移動
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
   • Gmail APIを有効にする
   • OAuth2 認証情報を作成する (デスクトップ アプリケーション タイプ)
   • クライアント構成をダウンロードする
3. Gmail の設定でconfig.yaml更新します。
   imap: host: imap.gmail.com port: 993 username: your-email@gmail.com use_ssl: true oauth2: client_id: YOUR_CLIENT_ID client_secret: YOUR_CLIENT_SECRET refresh_token: YOUR_REFRESH_TOKEN

使用法

メールをチェック

受信トレイ内のメールを一覧表示するには:

利用可能なオプション:

• --folder : チェックするフォルダを指定します（デフォルト: INBOX）
• --limit : 表示するメールの最大数（デフォルト: 10）
• --verbose : 詳細なログ出力を有効にする

MCPサーバーの起動

IMAP MCP サーバーを起動するには:

デバッグ付き開発モードの場合:

OAuth2トークンの管理

OAuth2 トークンを更新するには:

新しい OAuth2 トークンを生成するには:

発達

開発環境の設定

テストの実行

セキュリティに関する考慮事項

このMCPサーバーは、お客様のメールアカウントへのアクセスを必要とします。メールアカウントには、個人情報が含まれています。以下のセキュリティ上の考慮事項にご注意ください。

• 環境変数または安全な資格情報ストレージを使用して電子メール資格情報を安全に保存します
• メインアカウントのパスワードの代わりにアプリ固有のパスワードの使用を検討してください
• フォルダへのアクセスをユースケースに必要なものだけに制限する
• メールプロバイダーの設定でサーバーに付与された権限を確認します

プロジェクトロードマップ

• [x] プロジェクトの初期化とリポジトリのセットアップ
• [x] 基本的なIMAP統合
• [x] メールリソースの実装
• [x] メールツールの実装
• [x] メールの返信と下書き機能
• [ ] ユーザー嗜好学習の実装
• [ ] 高度な検索機能
• [ ] 複数アカウントのサポート
• [ ] 主要メールプロバイダーとの統合

貢献

貢献を歓迎します！ガイドラインについてはCONTRIBUTING.mdをご覧ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

• フレームワークを提供するためのモデルコンテキストプロトコル
• クロードの発展のための人類学的
• このプロジェクトを可能にするさまざまなPython IMAPライブラリ