MCP Email Server MCP Server

MCP Email Server

Gmail と IMAP アカウントの両方をサポートする、統合メール管理用の包括的な Model Context Protocol (MCP) サーバーです。

🚀 機能

• MCP プロトコル対応: ストリーミングHTTP MCPサーバー
• Gmail 統合: OAuth2ベースのGmail API アクセスと自動トークン管理
• IMAP サポート: 各種メールプロバイダーへの安全なIMAP接続
• 統一インターフェース: 自動検出機能付きのすべてのメールアカウント用単一MCPインターフェース
• アカウント管理: 一元化された設定と接続テスト
• 堅牢なエラーハンドリング: 詳細なユーザーガイダンス付きの包括的なタイムアウトとエラー管理
• セキュリティ: IMAPアカウント用の暗号化パスワードストレージ
• クロスアカウント検索: 設定済みのすべてのアカウントを同時に検索

📋 利用可能なMCPツール

🔄 統合ツール（アカウント種別自動判定）

🔧 管理ツール

🛠️ 利用可能なスクリプト

scripts/ ディレクトリに配置：

📧 認証とセットアップ

🖥️ サーバー管理

⚙️ インストールとセットアップ

1. インストール

git clone <repository-url>
cd mcp-email-server
npm install

2. 環境設定

# 環境設定ファイルのサンプルをコピー
cp .env.example .env

# 設定を編集
nano .env

3. 必要な環境変数

# 必須 - パスワード保存用暗号化キー
EMAIL_ENCRYPTION_KEY=your-unique-32-character-encryption-key

# Gmail OAuth2設定（Gmailを使用する場合）
GMAIL_CLIENT_ID=your-gmail-client-id
GMAIL_CLIENT_SECRET=your-gmail-client-secret  
GMAIL_REDIRECT_URI=urn:ietf:wg:oauth:2.0:oob

# Gmailアカウントトークン（OAuthスクリプトで取得）
GMAIL_REFRESH_TOKEN_accountname=your-refresh-token

# IMAPアカウント設定（IMAPを使用する場合）
IMAP_HOST_accountname=mail.example.com
IMAP_USER_accountname=user@example.com
IMAP_PASSWORD_accountname=encrypted-password-here
IMAP_PORT_accountname=993
IMAP_TLS_accountname=true

4. アカウントセットアップ

Gmailアカウント

# 最初に.envファイルにGmail OAuth2認証情報を設定し、その後：
node scripts/gmail-desktop-auth.mjs ACCOUNT_NAME

# 認証完了後、サーバーを再起動して設定を反映：
./scripts/server.sh restart

IMAPアカウント

# 対話式IMAPセットアップ（推奨）：
node scripts/setup-xserver.mjs

# または手動でパスワードを暗号化：
npx tsx scripts/encrypt-password.ts "あなたのパスワード"

5. サーバー起動と確認

# サーバー起動（LaunchAgent使用）
./scripts/server.sh start

# サーバー状態確認
./scripts/server.sh status

# 包括的ヘルスチェック（推奨）
./scripts/server.sh health
# または
npm run health:check

# 完全テストスイート
npm test

🔧 MCP設定

Cursor MCPセットアップ（推奨）

Cursor MCP設定ファイル (~/.cursor/mcp.json) に追加：

{
  "mcpServers": {
    "mcp-email-server": {
      "url": "http://localhost:3456/mcp",
      "transport": "http"
    }
  }
}

【注意】認証なしで接続されるので、サーバーは絶対公開しないでください。

🖥️ サーバーとテスト

bin/ ディレクトリに配置：

MacOSの常時起動方法

ストリーミングHTTPサーバーMCPですので、サーバーは利用時常時起動で運用してください。 macOSの場合、以下のようなLaunchAgentのplistファイルを作成しておくと便利です。 /PATH/TOは適切なパスに置換してください。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<dict>
    <key>Label</key>
    <string>localhost.mcp-email-server</string>
    <key>Program</key>
    <string>/PATH/TO/tsx</string>
    <key>ProgramArguments</key>
    <array>
        <string>/PATH/TO/.nvm/versions/node/v23.7.0/bin/tsx</string>
        <string>/PATH/TO/mcp-email-server/bin/run-streaming-email-server.ts</string>
    </array>
    <key>WorkingDirectory</key>
    <string>/PATH/TO/src/git/mcp-email-server</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/PATH/TO/Library/Logs/mcp-email-server.log</string>
    <key>StandardErrorPath</key>
    <string>/PATH/TO/Library/Logs/mcp-email-server-error.log</string>