kgromero-mcp

An MCP server for kgromero.com. It lets AI assistants (Claude, Cursor, etc.) answer questions about Kyle Romero's experience, skills, projects, and portfolio from the content on the site.

Use it

The server is hosted at https://kgromero.com/mcp (Streamable HTTP, read-only, no sign-in).

claude mcp add --transport http kgromero https://kgromero.com/mcp

In Claude (web/desktop): Settings → Connectors → Add custom connector → paste the URL. In Cursor and other clients:

{ "mcpServers": { "kgromero": { "url": "https://kgromero.com/mcp" } } }

Or run it locally from PyPI over stdio:

uvx kgromero-mcp

{ "mcpServers": { "kgromero": { "command": "uvx", "args": ["kgromero-mcp"] } } }

It's also listed in the MCP Registry as io.github.romero927/kgromero-mcp.

How it works

Data comes from the live site and is cached for an hour:

• https://kgromero.com/api/resume: resume in JSON Resume format
• https://kgromero.com/api/site.json: the rest of the home page (title timeline, skill categories, side projects, documents, interests, travel)
• https://kgromero.com/kgromero.md: resume as Markdown

If the site can't be reached, the server uses the copies bundled in src/kgromero_mcp/snapshot/.

Tools

Resources: resume://kgromero/json, resume://kgromero/markdown, resume://kgromero/site

Prompt: assess_job_fit(job_description): compares the resume to a job posting.

Run it locally

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/kgromero-mcp            # stdio (for local clients)
.venv/bin/kgromero-mcp --http     # Streamable HTTP at http://127.0.0.1:8000/mcp

Claude Code

claude mcp add kgromero -- /path/to/kgromero-mcp/.venv/bin/kgromero-mcp

Claude Desktop / other clients

{
  "mcpServers": {
    "kgromero": { "command": "/path/to/kgromero-mcp/.venv/bin/kgromero-mcp" }
  }
}

Settings

Deployment

Runs on Fly.io as the kgromero-mcp app (Dockerfile, fly.toml). The machine stops when idle and starts on the next request. kgromero.com/mcp forwards to https://kgromero-mcp.fly.dev/mcp through a route in the site repo (src/routes/mcp/+server.js).

fly deploy --remote-only

Releasing

1. Bump the version in pyproject.toml and in both places in server.json.
2. Commit, then git tag vX.Y.Z && git push origin vX.Y.Z.

.github/workflows/publish.yml checks the versions match the tag, runs the tests, publishes to PyPI, and then updates the MCP Registry listing. PyPI uses trusted publishing (GitHub environment pypi) and the registry uses GitHub OIDC, so no secrets are stored.

Development

.venv/bin/pytest

Tests run offline against the snapshot. To refresh it after editing the site:

curl -s https://kgromero.com/api/resume    > src/kgromero_mcp/snapshot/kgromero.json
curl -s https://kgromero.com/api/site.json > src/kgromero_mcp/snapshot/site.json
curl -s https://kgromero.com/kgromero.md   > src/kgromero_mcp/snapshot/kgromero.md