Gemini Email Subject Generator MCP

Gemini Email Subject Generator MCP

Google の Gemini Flash 2 AI モデルを活用して、魅力的なメールの件名と詳細な思考プロセスを生成する強力な Model Context Protocol（MCP）サーバーです。このツールは Claude Desktop とシームレスに連携し、インテリジェントなメール件名の生成と高度なコンテンツ作成を実現します。

🌟 機能

1. AI による件名生成機能付きメールツール（send-email）

• Gemini Flash 2 を使用して AI 生成の件名付きメールを送信します
• 機能：
  • 指定したプロンプトに基づく動的な件名生成
  • HTML およびプレーンテキストのメール本文に対応
  • インライン表示に対応した画像添付
  • 環境変数を使用した安全な認証
  • エラー処理とステータス報告
  • リッチな書式設定オプションによる、完全にカスタマイズ可能なコンテンツ
  • メッセージ追跡に対応した即時配信

2. 思考生成ツール（generate-thinking）

• Gemini の Flash 2 モデルを使用して、詳細な思考プロセスのテキストを生成します
• 複雑な推論と分析に対応
• タイムスタンプ付きで応答を保存
• 出力ディレクトリをカスタマイズ可能
• ブレインストーミング、計画、コンテンツ作成に最適

🚀 クイックスタート

前提条件

• Node.js（v16 以降）
• TypeScript
• Claude Desktop
• Google Gemini API キー
• SMTP メールアカウント（メール機能用）

インストール

1. クローンしてセットアップします：

git clone [your-repo-url]
cd gemini-email-subject-generator
npm install

2. .env ファイルを作成します：

GEMINI_API_KEY=your_api_key_here
[email protected]
NODEMAILER_PASSWORD=your_app_password_here

3. プロジェクトをビルドします：

npm run build

Claude Desktop の設定

1. %AppData%/Claude/claude_desktop_config.json を作成または編集します：

{
  "mcpServers": {
    "Gemini Email Generator": {
      "command": "node",
      "args": ["path/to/gemini-email-subject-generator/dist/index.js"],
      "cwd": "path/to/gemini-email-subject-generator",
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "NODEMAILER_EMAIL": "[email protected]",
        "NODEMAILER_PASSWORD": "your_app_password_here"
      }
    }
  }
}

2. Claude Desktop を再起動します

📊 ツールの使用方法

AI による件名生成を利用したメール送信

{
  "name": "send-email",
  "arguments": {
    "to": "[email protected]",
    "subjectPrompt": "Create a catchy subject line for a marketing email about our new AI-powered analytics platform",
    "text": "Hello! This is the plain text version of our email.",
    "html": "<h1>Hello!</h1><p>This is the <b>HTML</b> version of our email with an inline image: <img src='cid:image0'/></p>",
    "images": [
      {
        "name": "chart.png",
        "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
      }
    ]
  }
}

重要：メールツールについて：send-email ツールを使用すると、Claude はメールが正常に送信されたことを示す確認メッセージを表示します。この確認メッセージはメール本文ではなく、操作が成功したことを知らせるフィードバックです。受信者に送信される実際のメールには、text フィールドと html フィールドで指定した内容のみが含まれ、件名はプロンプトに基づいて Gemini が生成します。

思考の生成

{
  "name": "generate-thinking",
  "arguments": {
    "prompt": "Your complex analysis prompt here",
    "outputDir": "./custom_output"
  }
}

📁 出力構成

output/
└── thinking/
    └── gemini_thinking_[timestamp].txt

🛠️ 開発

使用可能なスクリプト

• npm run build：TypeScript を JavaScript にコンパイルします
• npm run start：MCP サーバーを起動します
• npm run dev：ts-node を使用して開発モードで実行します

環境変数

• GEMINI_API_KEY：Google Gemini API キー
• NODEMAILER_EMAIL：メール送信用のメールアドレス
• NODEMAILER_PASSWORD：メールアプリのパスワード（Gmail ではアプリパスワードを使用してください）

🔒 セキュリティに関する注意事項

• API キーは安全に保管してください
• .env ファイルを共有しないでください
• Gmail では、メインアカウントのパスワードではなくアプリパスワードを使用してください
• システムを通じて送信するメールの内容には十分注意してください
• メールの例には機密情報や個人情報を含めないでください

🐛 トラブルシューティング

よくある問題

1. API キーのエラー

   • .env ファイルが存在することを確認してください
   • API キーが有効か確認してください
   • 環境変数が正しく読み込まれていることを確認してください

2. Claude Desktop の接続

   • config.json の構文を確認してください
   • 設定内のファイルパスを確認してください
   • Claude Desktop を再起動してください

3. メール送信の問題

   • NODEMAILER_EMAIL と NODEMAILER_PASSWORD が正しく設定されていることを確認してください
   • Gmail の場合は、アプリパスワードを作成済みであることを確認してください
   • Gmail 以外のプロバイダーでは、安全性の低いアプリへのアクセスが有効になっていることを確認してください
   • 受信者のメールアドレスの形式を確認してください
   • 画像データがデータ URI（data:image/type;base64,）として正しくフォーマットされていることを確認してください

デバッグモード

詳細なログを出力するには、.env ファイルに DEBUG=true を追加します：

GEMINI_API_KEY=your_key_here
DEBUG=true

📚 API リファレンス

メール送信ツール

interface SendEmailParams {
  to: string;              // Recipient email address
  subjectPrompt: string;   // Prompt for generating email subject
  text: string;            // Plain text version of email
  html?: string;           // HTML version of email (optional)
  images?: {               // Optional images to attach
    name: string;          // Image filename
    data: string;          // Base64 encoded image data
  }[];
}

思考生成ツール

interface GenerateThinkingParams {
  prompt: string;           // Analysis prompt
  outputDir?: string;       // Optional output directory
}

🤝 コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. Pull Request を作成します

📄 ライセンス

MIT License — 詳細は LICENSE ファイルを参照してください