CV REST/MCP Server

FastAPI + FastMCP service that renders a CV as JSON or themed PDFs.

Run

just setup && just dev

Server: http://localhost:8080 · MCP: /mcp (JSON-RPC, not a browser page)

Related MCP server: MCP-Server

REST API

Interactive OpenAPI docs (Swagger UI): /docs

MCP

Mounted at /mcp via Streamable HTTP transport.

Tools

Connect from an MCP client

Any MCP-compatible client (Claude Desktop, Cursor, VS Code with Kilo, Windsurf) can use this server. Add to your client's MCP config:

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

For a deployed instance, replace the URL with your public endpoint.

Themes

classic · minimal · modern · original — defined in app/themes/<name>.py as CSS strings.

Content & Customization

Edit data/cv.json (validated against CVData in app/cv_data.py). Restart after changes.

Set CV_DATA_PATH to point to a different JSON file. See data/cv.example.json for the full schema.

Rate Limiting

Per-IP, in-memory. localhost exempt.

Docker

just build && just run

GCP Deploy

Pushes to main run CI and, after both quality and test jobs pass, deploy to Cloud Run automatically. Add [skip deploy] to a commit message to run CI without deploying. GitHub-native [skip ci], [ci skip], [no ci], [skip actions], and [actions skip] skip the workflow entirely, which can leave required checks pending.

The one-time operator setup uses the deploy script (idempotent; SVC_NAME in .env names the service, image, and derived service accounts):

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

For a normal code release, push a green change to main; do not run the build/deploy/verify stages manually. The CD verify job prints the deployed URL. It is also visible in Google Cloud Console under Cloud Run, the service, then URL. The CLI lookup uses the current SVC_NAME and GCP_REGION; service account IDs do not form part of the URL.

Stack

FastAPI · FastMCP v3 · WeasyPrint · Jinja2 · Cloud Run-compatible (stateless, $PORT-aware)