Gemini Email Subject Generator MCP

Gemini 邮件主题生成器 MCP

一个功能强大的模型上下文协议（MCP）服务，利用 Google 的 Gemini Flash 2 AI 模型生成吸引人的邮件主题和详细的思考过程。此工具可与 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 服务商，请确认已启用对安全性较低的应用的访问权限
   • 检查收件人邮箱地址格式
   • 确保图片数据已正确格式化为 data 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. Fork 此仓库
2. 创建功能分支
3. 提交更改
4. 将更改推送到该分支
5. 创建 Pull Request

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件