📧 冷邮件助手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-docxGmail应用程序密码设置
- 在您的Google帐户上启用双因素身份验证
- 首选 谷歌应用密码
- 为“邮件”生成新的应用程序密码
- 在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.docx3.生成个性化电子邮件
Using the job details and my resume, generate a personalized cold email4.另存为草稿
Save this email as a draft to recruiter@company.com5.或直接发送
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