AI导哈

冷邮件助手

一个自动化求职冷邮件外联的MCP服务器，可解析招聘信息、使用AI生成个性化邮件并通过Gmail发送或保存为草稿。

  • by AmeyMedewar
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AmeyMedewar/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 <repository-url>
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

相关 MCP