English Français العربية

Kyle Romero (kgromero.com)

Registre officiel Autres

Ask about Kyle Romero's experience, skills, projects, and portfolio from kgromero.com.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http kyle-romero-kgromero-com 'https://kgromero.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kyle-romero-kgromero-com": {
            "type": "http",
            "url": "https://kgromero.com/mcp"
        }
    }
}
PYPI package kgromero-mcp
Claude Code 
claude mcp add kyle-romero-kgromero-com -- uvx kgromero-mcp==0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kyle-romero-kgromero-com": {
            "command": "uvx",
            "args": [
                "kgromero-mcp==0.1.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. kgromero-mcp
  2. Use it
  3. How it works
  4. Tools
  5. Run it locally
  6. Deployment
  7. Releasing
  8. Development

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

ToolWhat it returns
get_profileName, title, summary, about, location, current role, years of experience
get_contactEmail, phone, LinkedIn/GitHub/Keyoxide, vCard link
list_experienceOne entry per employer with dates and length
get_experience(company_or_id)Full highlights and tech stack for a role
get_career_timelineEvery title held, including promotions
get_educationDegrees
get_skills(filter?)Skills by category, and tech used on the job with where and how recently
list_side_projectsPersonal projects with GitHub links
list_documents(group?)Resume downloads plus the portfolio (diagrams, write-ups, lab reports) by employer
get_interestsHobbies and favorite tech news sites
get_travel(lived_only?)Places lived and visited
search(query)Keyword search across all of the above

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
Env varDefaultPurpose
KGROMERO_SITE_URLhttps://kgromero.comPoint at another deployment, e.g. http://localhost:5173
KGROMERO_OFFLINEunsetSet to 1 to skip the network and use the bundled snapshot

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

Questions fréquentes

Qu'est-ce que Kyle Romero (kgromero.com) ?

Ask about Kyle Romero's experience, skills, projects, and portfolio from kgromero.com.

Comment installer Kyle Romero (kgromero.com) ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http kyle-romero-kgromero-com 'https://kgromero.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Kyle Romero (kgromero.com) ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Kyle Romero (kgromero.com) est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Kyle Romero (kgromero.com) ?

Il est publié par romero927. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.