AI导哈

邮件主题生成工具

一款利用Google Gemini Flash 2 AI模型生成吸引人邮件主题和详细思考过程的工具，支持与Claude Desktop无缝集成。

  • by falahgs
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 falahgs/gemini-email-subject-generator-mcp

使用说明

Gemini电子邮件主题生成器MCP

一个强大的模型上下文协议（MCP）服务器，利用谷歌的Gemini Flash 2 AI模型生成引人入胜的电子邮件主题和详细的思维过程。该工具与Claude Desktop无缝集成，提供智能电子邮件主题生成和高级内容创建。

🌟 特性

1.具有AI主题生成功能的电子邮件工具(send-email)

  • 使用Gemini Flash 2发送带有人工智能生成主题的电子邮件
  • 特征：
    • 基于提供的提示动态生成主题
    • 支持HTML和纯文本电子邮件内容
    • 具有内联显示功能的图像附件
    • 使用环境变量进行安全身份验证
    • 错误处理和状态报告
    • 具有丰富格式选项的完全可定制内容
    • 即时交付，消息跟踪

2.思维生成工具(generate-thinking)

  • 使用Gemini的Flash 2模型生成详细的思维过程文本
  • 支持复杂的推理和分析
  • 保存带有时间戳的响应
  • 可定制的输出目录
  • 非常适合头脑风暴、规划和内容创作

🚀 快速开始

先决条件

  • Node.js（v16或更高版本）
  • TypeScript
  • 克劳德桌面
  • Google Gemini API密钥
  • SMTP电子邮件帐户（用于电子邮件功能）

安装

  1. 克隆和设置：
git clone [your-repo-url]
cd gemini-email-subject-generator
npm install
  1. 创建 .env 文件：
GEMINI_API_KEY=your_api_key_here
NODEMAILER_EMAIL=your.email@gmail.com
NODEMAILER_PASSWORD=your_app_password_here
  1. 构建项目：
npm run build

Claude桌面配置

  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": "your.email@gmail.com",
        "NODEMAILER_PASSWORD": "your_app_password_here"
      }
    }
  }
}
  1. 重新启动克劳德桌面

📊 使用工具

使用人工智能生成主题的电子邮件发送

{
  "name": "send-email",
  "arguments": {
    "to": "recipient@example.com",
    "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节点在开发模式下运行

环境变量

  • GEMINI_API_KEY：您的Google Gemini API密钥
  • NODEMAILER_EMAIL：用于发送电子邮件的电子邮件地址
  • NODEMAILER_PASSWORD：您的电子邮件应用程序密码（对于Gmail，请使用应用程序密码）

🔒 安全说明

  • 安全地存储API密钥
  • 不要分享你的 .env 文件
  • 对于Gmail，使用应用程序密码而不是主帐户密码
  • 小心通过系统发送的电子邮件内容
  • 切勿在电子邮件示例中包含敏感或个人信息

🐛 故障排除

常见问题

  1. API密钥错误

    • 验证 .env 文件存在
    • 检查API密钥的有效性
    • 确保适当的环境负载

  2. Claude桌面连接

    • 验证config.json语法
    • 检查配置中的文件路径
    • 重新启动克劳德桌面

  3. 电子邮件发送问题

    • 检查NODEMAILER_EMAIL和NODEMAILER_PASSWORD是否设置正确
    • 对于Gmail，请确保您已创建应用程序密码
    • 验证是否为非Gmail提供商启用了不太安全的应用程序访问
    • 检查收件人电子邮件地址格式
    • 确保图像数据正确格式化为数据URI（data:image/type；base64，）

调试模式

添加 DEBUG=true 到你的 .env 详细日志记录文件：

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. 创建拉取请求

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件

相关 MCP