CV REST/MCP сервер

Сервис FastAPI + FastMCP, который отображает резюме в формате JSON или тематических PDF.

Запуск

just setup && just dev

Сервер: http://localhost:8080 · MCP: /mcp (JSON-RPC, не браузерная страница)

Related MCP server: MCP-Server

REST API

Интерактивная документация OpenAPI (Swagger UI): /docs

MCP

Смонтировано на /mcp через транспорт Streamable HTTP.

Инструменты

Подключение из MCP-клиента

Любой MCP-совместимый клиент (Claude Desktop, Cursor, VS Code с Kilo, Windsurf) может использовать этот сервер. Добавьте в конфигурацию MCP вашего клиента:

{
  "mcpServers": {
    "cv-rest-mcp-server": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Для развернутого экземпляра замените URL на ваш публичный endpoint.

Темы

classic · minimal · modern · original — определены в app/themes/<name>.py как строки CSS.

Содержимое и настройка

Отредактируйте data/cv.json (проверяется на соответствие CVData в app/cv_data.py). Перезапустите после изменений.

Установите CV_DATA_PATH, чтобы указать на другой JSON-файл. Полную схему см. в data/cv.example.json.

Ограничение частоты запросов

По IP, в памяти. localhost освобожден.

Docker

just build && just run

Развертывание в GCP

Пуши в main запускают CI, и после прохождения заданий качества и тестов автоматически выполняется развертывание в Cloud Run. Добавьте [skip deploy] в сообщение коммита, чтобы запустить CI без развертывания. Нативные для GitHub [skip ci], [ci skip], [no ci], [skip actions] и [actions skip] полностью пропускают workflow, что может оставить обязательные проверки в статусе ожидания.

Одноразовая настройка оператора использует скрипт развертывания (идемпотентный; SVC_NAME в .env задает имя сервиса, образа и производных сервисных аккаунтов):

just deploy bootstrap                                  # first full run
just deploy upload-cv                                   # publish personal CV data
just deploy wif                                        # one-time GitHub OIDC wiring

Для обычного релиза кода отправьте зеленое изменение в main; не запускайте этапы сборки/развертывания/проверки вручную. Задание проверки CD выводит URL развернутого сервиса. Он также виден в Google Cloud Console в разделе Cloud Run, затем сервис, затем URL. Поиск через CLI использует текущие SVC_NAME и GCP_REGION; идентификаторы сервисных аккаунтов не являются частью URL.

Стек

FastAPI · FastMCP v3 · WeasyPrint · Jinja2 · совместим с Cloud Run (без состояния, учитывает $PORT)