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": "
Hello!

This is the HTML version of our email with an inline image: 
",
    "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密钥的有效性 - 确保适当的环境负载

1. Claude桌面连接

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

1. 电子邮件发送问题

- 检查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许可证-有关详细信息，请参阅许可证文件