git clone 
cd mcp-email-server
npm install

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

# 設定を編集
nano .env

# 必須 - パスワード保存用暗号化キー
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

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

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

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

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

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

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

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

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

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

Label
    localhost.mcp-email-server
    Program
    /PATH/TO/tsx
    ProgramArguments
    
        /PATH/TO/.nvm/versions/node/v23.7.0/bin/tsx
        /PATH/TO/mcp-email-server/bin/run-streaming-email-server.ts
    
    WorkingDirectory
    /PATH/TO/src/git/mcp-email-server
    RunAtLoad
    
    KeepAlive
    
    StandardOutPath
    /PATH/TO/Library/Logs/mcp-email-server.log
    StandardErrorPath
    /PATH/TO/Library/Logs/mcp-email-server-error.log
    EnvironmentVariables
    
        PATH
        /PATH/TO/NODE/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
        NODE_PATH
        /PATH/TO/NODE/lib/node_modules

launchctl load ~/Library/LaunchAgents/localhost.mcp-email-server.plist

// 設定済みアカウントを全て一覧表示
mcp_mcp-email-server_list_accounts()

// 特定アカウントの接続テスト
mcp_mcp-email-server_test_connection("business_gmail")

// 全アカウントの包括的統計情報を取得
mcp_mcp-email-server_get_account_stats()

// 全アカウントを横断検索
mcp_mcp-email-server_search_all_emails({
  query: "invoice",
  accounts: "ALL",
  limit: 20,
  sortBy: "date"
})

// 特定アカウントからメール一覧を取得
mcp_mcp-email-server_list_emails({
  account_name: "business_gmail",
  limit: 10,
  unread_only: true
})

// メール送信（Gmail/IMAP自動判定）
mcp_mcp-email-server_send_email({
  account_name: "business_gmail",
  to: "recipient@example.com",
  subject: "会議スケジュール",
  text: "来週の会議のスケジュールを組みましょう。",
  cc: "manager@example.com"
})

// メールをアーカイブ
mcp_mcp-email-server_archive_email({
  account_name: "business_gmail", 
  email_id: "email_id_here"
})

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

# 特定のテストカテゴリ
npm run test:core          # コア機能テスト
npm run test:integration   # 統合テスト
npm run test:imap-timeout  # IMAPタイムアウト防止テスト

# ヘルスモニタリング
npm run health:check       # 包括的ヘルスチェック
npm run test:quick         # 高速接続テスト

# 1. ヘルスチェック実行
npm run health:check

# 2. エラーパターンに応じて対処
# パターンA: Gmail認証エラー
node scripts/gmail-desktop-auth.mjs ACCOUNT_NAME
./scripts/server.sh restart

# パターンB: サーバー再起動のみ必要
./scripts/server.sh restart

# パターンC: IMAP認証エラー
npx tsx scripts/decrypt-test.ts

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

# サーバー再起動（認証後は必須）
./scripts/server.sh restart

# ログ確認
./scripts/server.sh logs
./scripts/server.sh logs error

# 横断検索テスト
./scripts/test-search-all.sh

# 個別アカウントテスト
curl -X POST http://localhost:3456/mcp \
  -H "Content-Type: application/json" \
  -d '{"method":"tools/call","params":{"name":"test_connection","arguments":{"account_name":"ACCOUNT_NAME"}}}'

# 定期ヘルスチェック（推奨: 毎日）
./scripts/server.sh health

# 定期再起動（推奨: 週1回）
./scripts/server.sh restart

# 詳細ログでサーバー起動
DEBUG=1 npx tsx bin/run-streaming-email-server.ts

# 開発モードで実行
NODE_ENV=development npx tsx bin/run-streaming-email-server.ts