job-mcp

FastMCP-сервер (транспорт stdio) с:

• Ресурс cv://profile — ваше резюме (CV) в формате JSON, которое может прочитать LLM-клиент.

• Инструмент send_email — отправляет письмо по SMTP с помощью Red Mail.

Рабочий процесс: вы передаёте MCP-клиенту в чате вакансию + email рекрутера → клиент читает 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

Он будет находиться в ожидании MCP JSON-RPC-сообщений через stdin/stdout (это нормально — он предназначен для запуска MCP-клиентом, а не для интерактивного использования).

Вы также можете просмотреть его с помощью MCP dev inspector:

mcp dev src/job_mcp/server.py

5. Подключение к MCP-клиенту

Пример конфигурации для клиента, который запускает серверы через stdio (например, claude_desktop_config.json для Claude Desktop):

{
  "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. Использование

В клиенте вставьте что-то вроде:

Вот вакансия и email рекрутера. Прочитай мой CV-ресурс, затем составь и отправь адаптированное сопроводительное письмо.

Вакансия: <вставьте текст> Email рекрутера: hr@company.com

Клиент должен вызвать cv://profile, составить письмо, используя оба фрагмента контекста, и затем вызвать send_email(to=..., subject=..., body_html=..., body_text=...).

Примечания / что стоит укрепить позже

• Сейчас в send_email нет встроенного в сам сервер шага подтверждения — если вы хотите, чтобы защитный механизм «проверка перед отправкой» обеспечивался на стороне сервера (а не только на стороне клиента), добавьте двухэтапный процесс (например, инструмент draft_email, который возвращает предпросмотр + id, и инструмент confirm_send, который непосредственно отправляет письмо).

• Рассмотрите ограничение частоты (rate limiting) или логирование отправленных писем, чтобы избежать случайных повторных отправок.

• cv.json читается заново при каждом обращении к ресурсу, поэтому вы можете редактировать его без перезапуска сервера.