双子星邮件主题生成器-MCP

Name: 双子星邮件主题生成器-MCP
Author: falahgs

作者：falahgs2 星标更新：2025-04-13

安装使用来源：spider==github.com

项目介绍

Gemini 邮件主题生成器 MCP

一款强大的模型上下文协议（MCP）服务器，利用Google的Gemini Flash 2人工智能模型生成吸引人的邮件主题和详细的思考过程。此工具与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电子邮件账户（用于邮件功能）

安装

克隆并设置：

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

创建.env文件：

GEMINI_API_KEY=your_api_key_here
NODEMAILER_EMAIL=your.email@gmail.com
NODEMAILER_PASSWORD=your_app_password_here

构建项目：

npm run build

Claude Desktop配置

创建/编辑%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"
      }
    }
  }
}

重启Claude Desktop

📊 使用工具

带有AI主题生成的邮件发送

{
  "name": "send-email",
  "arguments": {
    "to": "recipient@example.com",
    "subjectPrompt": "为关于我们新的人工智能驱动分析平台的营销邮件创建一个引人注目的主题行",
    "text": "你好！这是邮件的纯文本版本。",
    "html": "<h1>你好！</h1><p>这是带有内联图像的<b>HTML</b>版本的邮件：<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": "在这里放置你的复杂分析提示",
    "outputDir": "./custom_output"
  }
}

📁 输出结构

output/
└── thinking/
    └── gemini_thinking_[时间戳].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，请使用应用密码而不是你的主账户密码
注意通过系统发送的邮件内容
切勿在邮件示例中包含敏感或个人信息

🐛 故障排除

常见问题

API密钥错误
- 验证.env文件是否存在
- 检查API密钥的有效性
- 确保正确加载环境
Claude Desktop连接
- 验证config.json语法
- 检查配置中的文件路径
- 重启Claude Desktop
邮件发送问题
- 检查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;              // 收件人电子邮件地址
  subjectPrompt: string;   // 生成邮件主题的提示
  text: string;            // 邮件的纯文本版本
  html?: string;           // 邮件的HTML版本（可选）
  images?: {               // 可选的附加图片
    name: string;          // 图像文件名
    data: string;          // base64编码的图像数据
  }[];
}

思考生成工具

interface GenerateThinkingParams {
  prompt: string;           // 分析提示
  outputDir?: string;       // 可选的输出目录
}

🤝 贡献

分叉仓库
创建你的特性分支
提交更改
推送到分支
创建拉取请求

📄 许可证

MIT许可证 - 查看LICENSE文件获取详情