job-mcp

一个使用 FastMCP 的服务器（stdio 传输），包含：

• 资源 cv://profile —— 你的简历/履历，以 JSON 格式提供，供 LLM 客户端读取。

• 工具 send_email —— 通过 SMTP 发送电子邮件，使用 Red Mail。

工作流程：你在聊天中向 MCP 客户端提供职位信息 + 招聘人员的邮箱 → 客户端 读取 cv://profile → 起草一封定制的求职邮件 → 调用 send_email 发送它。

1. 安装

cd job-mcp
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Related MCP server: MCP Server

2. 配置 SMTP 凭据

cp .env.example .env

编辑 .env，填入你的 SMTP 主机/凭据。对于 Gmail，请使用 应用专用密码（不要使用你的普通登录密码）， 并且需要先开启两步验证。

3. 填写你的简历

编辑 src/job_mcp/data/cv.json，填入你的真实信息（联系方式、技能、工作经历、 教育背景、项目、证书）。该资源只是按原样读取这个文件。

4. 独立运行服务器（快速检查）

python -m job_mcp.server

它会一直等待通过 stdin/stdout 传入的 MCP JSON-RPC 消息（这是正常的——它 本来就是由 MCP 客户端启动的，而不是用于交互式使用）。

你还可以使用 MCP 开发检查器来检查它：

mcp dev src/job_mcp/server.py

5. 将其连接到 MCP 客户端

客户端通过 stdio 启动服务器的示例配置（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "job-mcp": {
      "command": "/absolute/path/to/job-mcp/.venv/bin/python",
      "args": ["-m", "job_mcp.server"],
      "env": {
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "you@gmail.com",
        "SMTP_PASSWORD": "your-app-password",
        "SMTP_SENDER_EMAIL": "you@gmail.com",
        "SMTP_SENDER_NAME": "Your Name"
      }
    }
  }
}

（你可以把凭据放在这里的 env 中，而不是放在 .env 里——两者都行，因为 config.py 无论如何都是从 os.environ 读取的。）

6. 使用它

在客户端中，粘贴类似这样的内容：

这是一份职位信息和招聘人员的邮箱。请读取我的简历资源，然后起草并 发送一封定制的求职邮件。

职位信息：<粘贴文本> 招聘人员邮箱：hr@company.com

客户端应该调用 cv://profile，使用这两部分上下文起草邮件， 然后调用 send_email(to=..., subject=..., body_html=..., body_text=...)。

备注 / 后续可以加固的地方

• send_email 目前服务器本身没有内置确认步骤——如果你想在服务器端（而不仅仅是客户端） 强制实施"发送前预览"的保护机制，可以添加一个两步流程（例如，一个返回预览 + id 的 draft_email 工具，以及一个真正发送邮件的 confirm_send 工具）。

• 考虑对已发送的邮件进行限流或记录日志，以避免意外的重复发送。

• cv.json 在每次资源调用时都会重新读取，因此你可以在不重启服务器的情况下编辑它。