English Français العربية

Kyle Romero (kgromero.com)

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http kyle-romero-kgromero-com 'https://kgromero.com/mcp'
إعداد 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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "kyle-romero-kgromero-com": {
            "command": "uvx",
            "args": [
                "kgromero-mcp==0.1.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Kyle Romero (kgromero.com)؟

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

كيف أثبّت Kyle Romero (kgromero.com)؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http kyle-romero-kgromero-com 'https://kgromero.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Kyle Romero (kgromero.com) إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Kyle Romero (kgromero.com) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Kyle Romero (kgromero.com)؟

ينشره romero927. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.