Cold Mailer MCP

📧 冷邮件助手MCP服务器

一种模型上下文协议（MCP）服务器，用于自动化工作申请的冷电子邮件外展。解析招聘信息，使用人工智能生成个性化电子邮件，并直接从Claude Desktop发送或保存为草稿。

✨ 特性

• 职位发布解析器：从WhatsApp消息中提取公司名称、角色、电子邮件、位置、津贴和要求
• 简历和提示加载：阅读Word文档中的简历和电子邮件模板
• 电子邮件发送：通过Gmail发送带有简历附件的个性化电子邮件
• 草稿保存：将电子邮件保存到Gmail草稿文件夹中，以便在发送前进行审核
• 简历附件：自动将您的简历（PDF）附加到所有电子邮件中

🚀 快速开始

先决条件

• Python 3.8+
• 启用了应用程序密码的Gmail帐户
• 支持MCP的Claude Desktop应用程序
• 简历文件(resume.pdf)
• 可选： resume.docx 和 prompt.docx 用于AI个性化

安装

# Clone the repository
git clone 
cd cold-email-assistant

# Install dependencies
pip install fastmcp python-docx

Gmail应用程序密码设置

1. 在您的Google帐户上启用双因素身份验证
2. 首选 谷歌应用密码
3. 为“邮件”生成新的应用程序密码
4. 在MCP服务器中使用此密码（不是您的常规Gmail密码）

配置MCP服务器

添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cold-email": {
      "command": "python",
      "args": ["/path/to/your/cold_email_mcp.py"]
    }
  }
}

更新电子邮件凭据

编辑 cold_email_mcp.py 归档并替换为您的详细信息：

sender_email: str = 'your-email@gmail.com'
sender_password: str = 'your-app-password'
resume_path: str = "resume.pdf"

📖 如何使用

1.解析职位发布

复制WhatsApp上的招聘信息，问克劳德：

Parse this job message:
[paste job posting text]

2.加载简历

Load my resume from resume.docx

3.生成个性化电子邮件

Using the job details and my resume, generate a personalized cold email

4.另存为草稿

Save this email as a draft to recruiter@company.com

5.或直接发送

Send this email to recruiter@company.com

🛠️ 可用工具

parse_job_message

从职位发布中提取结构化数据：

• 公司名称
• 角色/职位
• 电子邮件地址
• 位置
• 津贴/工资
• 批次/毕业年份
• 需求

load_resume

从以下网址阅读简历 .docx AI个性化文件

load_prompt

从加载自定义电子邮件模板 .docx 文件

send_email_tool

通过Gmail SMTP发送带有简历附件的电子邮件

save_to_draft_tool

将电子邮件保存到Gmail草稿文件夹以供审阅

📁 项目结构

cold-email-assistant/
├── cold_email_mcp.py      # MCP server code
├── resume.pdf             # Your resume (PDF format)
├── resume.docx            # Resume for text extraction (optional)
├── prompt.docx            # Email template (optional)
└── README.md

💡 使用技巧

• 审阅草稿：使用 save_to_draft_tool 发送前查看电子邮件
• 自定义模板：将您的电子邮件模板存储在 prompt.docx 为了保持一致性
• 批处理：分析多个职位发布并保存草稿以供以后审查
• AI个性化：让克劳德分析工作要求并定制您的电子邮件
• 隐私：应用程序密码比使用Gmail主密码更安全

🔒 安全

• 使用Gmail应用程序密码（不是您的主密码）
• 应用程序密码在脚本中硬编码（保持文件安全）
• 考虑将环境变量用于生产环境
• 通过TLS加密连接发送的电子邮件

🔧 故障排除

“错误：找不到简历文件”

• 确保 resume.pdf 与脚本位于同一目录中
• 检查 resume_path 参数

“身份验证失败”

• 验证您的Google帐户是否已启用2FA
• 生成新的应用程序密码
• 更新 sender_password 在脚本中

“连接被拒绝”

• 检查您的互联网连接
• 验证Gmail SMTP/IMAP是否已启用
• 检查防火墙设置

草稿未出现在Gmail中

• 等待几秒钟并刷新
• 检查“所有邮件”文件夹
• 确保在Gmail设置中启用IMAP

🚧 未来的增强功能

• \[\]凭据的环境变量支持
• \[\]支持多个电子邮件提供商
• \[\]电子邮件模板库
• \[\]延迟批量发送电子邮件
• \[\]电子邮件跟踪和后续提醒
• \[\]支持HTML电子邮件格式

📝 工作流示例

1. You: "Parse this job posting: [WhatsApp message]"
2. Claude: Extracts company, role, email, requirements

3. You: "Load my resume"
4. Claude: Reads resume.docx content

5. You: "Generate a personalized email for this role"
6. Claude: Creates tailored email based on job requirements

7. You: "Save as draft to recruiter@company.com"
8. Claude: Saves to Gmail Drafts with resume attached

9. Review draft in Gmail, make edits if needed, and send!

🤝 贡献

欢迎投稿、问题和功能请求！

______________________________________________________________________

由以下材料制成❤️ 使用FastMCP和Claude AI