mcpField
M
mcp-email-server

mcp-email-server

ローカル
github.com/ai-zerolabコミュニケーション3713 日前に更新
リポジトリ

mcp-email-server について

mcp-email-server は IMAP と SMTP を通じてメールの読み取り、検索、整理、送信を行う MCP サーバーです。Windows、macOS、Linux に対応し、設定 UI と従来設定を移行するためのコマンドラインツールを備えています。

主な機能

  1. 01IMAP によるメールの読み取りと検索
  2. 02SMTP によるメール送信
  3. 03メール整理用のツール
  4. 04メールアカウントを管理する設定 UI
  5. 05従来の設定からの移行手順

活用シーン

  1. 01MCP クライアントから最新のメールを確認
  2. 02エージェントによるメール通知の送信
  3. 03複数のメールアカウントの管理

MCP 対応

本プロジェクトは MCP サーバーであり、stdio 経由でメールの読み取り、検索、整理、送信に関するツールを MCP クライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "email-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
起動コマンドnpx -y @smithery/cli

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@smithery/cli

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

mcp-email-server

リリース ビルドステータス codecov ライセンス

IMAP と SMTP を通じてメールの閲覧、検索、整理、送信を行う MCP サーバーです。

メモ

バージョン 1.0.0 では Local Email App V2 が導入されます。パッケージを更新しても、PyPI 0.16.0 以前で作成した既存の設定は自動的にインポートされません。 これらの設定は後方互換性のある legacy モードで引き続き有効なため、必須の移行作業はありません。新しい管理ストレージを使用する場合は、 ご都合のよいときに設定を確認してインポートできます。

mcp-email-server は Windows、macOS、Linux に対応しています。プラットフォーム固有のファイルシステムと認証情報の保存に関する詳細は、 セキュリティをご覧ください。

既存のインストール環境からの任意の移行

Local Email App V2 を含む @latest リリースでは、プレビューで内容を確認してから実行できる CLI 移行機能を利用できます。

uvx mcp-email-server@latest config init \
  --database ~/.config/mcp-email-server/managed.sqlite3
uvx mcp-email-server@latest config import-legacy
uvx mcp-email-server@latest config import-legacy --apply
uvx mcp-email-server@latest config doctor

適用ステップでは計画が再度表示され、IMPORT の確認を求められます。すべてのインポートが完了すると管理モードが選択され、それ以外の場合は既存のレガシー設定が引き続き選択されます。元の TOML ファイルとレガシーのキーチェーン項目は変更されません。uvx mcp-email-server@latest ui を実行し、既存の設定をインポートを選択することもできます。インポートが成功したら、実行中の MCP クライアントを再起動してください。詳しい内容はアップグレードガイドとインポートのトラブルシューティングをご覧ください。

クイックスタート

1. メールアカウントを設定する

このソースチェックアウトから、uv を使って設定 UI を起動します。

uv sync
uv run mcp-email-server ui

Local Email App V2 を含むとリリースノートに記載された公開リリースでは、uvx mcp-email-server@latest ui が同等の一時的な実行方法です。

フォアグラウンドのコマンドは実行したままにしてください。まったく新規のインストール環境では、認証済みのブラウザーセッションによって、安全なローカル既定の場所にプライベートなアカウントストレージが用意されます。既存の TOML 設定または環境設定がある場合は、以前の設定を引き続き使用しながら、明示的にインポート内容を確認できます。アカウント優先の UI には、主な移動先としてメールアカウントと設定とヘルプのみがあります。まずメールアドレスとパスワードを入力してください。UI はメールドメインから一般的な接続設定を入力し、編集できる状態にします。送信メールの設定は任意です。必要な情報がすべて入力されたアカウントは、別途有効化しなくてもすぐに使用できます。必要に応じて、保存済みアカウントのパスワードとテストを使用し、選択した設定を適用するために MCP クライアントを再起動してください。

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

stdio には、UI と同じ V2 対応ディストリビューションを使用してください。公開されている V2 リリースの場合、次のサーバー定義を MCP クライアントに追加します。

{
  "mcpServers": {
    "mcp-email-server": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"]
    }
  }
}

設定を更新したら MCP クライアントを再起動してください。公開前にこのソースチェックアウトをテストする場合は、管理カタログと PyPI の @latest を組み合わせるのではなく、uv run --directory /absolute/path/to/mcp-email-server mcp-email-server stdio を実行してください。

3. 接続を確認する

設定済みのメールアカウントまたは最近のメッセージの一覧を表示するよう、クライアントに依頼してください。

その他の設定方法

SQLite を使用するマネージド CLI ワークフロー、Windows と POSIX のストレージ境界、ヘッドレス環境、複数アカウント、カスタム TLS 設定、環境変数による設定については、ドキュメントをご覧ください。リリース 1.6.2 以降では、Linux amd64／arm64 イメージも ghcr.io/wh1isper/mcp-email-server で公開されています。コンテナーの手順をご覧ください。

ドキュメント

開発

CONTRIBUTING.mdをご覧ください。

ライセンス

このプロジェクトは、LICENSEの条件に基づいてライセンスされています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。