Kyle Romero (kgromero.com)

kgromero-mcp

一个面向 kgromero.com 的 MCP 服务。它让 AI 助手（Claude、Cursor 等）根据网站内容回答有关 Kyle Romero 的经历、技能、项目和作品集的问题。

使用方法

该服务托管于 https://kgromero.com/mcp（Streamable HTTP，只读，无需登录）。

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

在 Claude（网页端 / 桌面端）中：设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。在 Cursor 和其他客户端中：

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

或者通过 PyPI 在本地使用 stdio 运行：

uvx kgromero-mcp

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

它也已列入 MCP Registry，条目为 io.github.romero927/kgromero-mcp。

工作原理

数据来自实时网站，并缓存一小时：

• https://kgromero.com/api/resume：采用 JSON Resume 格式的简历
• https://kgromero.com/api/site.json：主页的其余内容（职位时间线、技能类别、个人项目、文档、兴趣、旅行）
• https://kgromero.com/kgromero.md：Markdown 格式的简历

如果无法访问网站，服务会使用打包在 src/kgromero_mcp/snapshot/ 中的副本。

工具

工具	返回内容
get_profile	姓名、职位、简介、关于、地点、当前职位、工作年限
get_contact	电子邮件、电话、LinkedIn/GitHub/Keyoxide、vCard 链接
list_experience	每家雇主一条记录，包含日期和任职时长
get_experience(company_or_id)	某职位的完整亮点和技术栈
get_career_timeline	所有担任过的职位，包括晋升记录
get_education	学位
get_skills(filter?)	按类别整理的技能，以及工作中使用的技术、使用场景和近期使用情况
list_side_projects	个人项目及其 GitHub 链接
list_documents(group?)	简历下载，以及按雇主分类的作品集（图表、说明文档、实验报告）
get_document(document, pages?, as_images?)	读取列出的文档：PDF 文本、作为图像的图表、渲染为图像的 PDF 页面（每次最多 5 页），以及原始文件的链接
get_interests	爱好和喜爱的科技新闻网站
get_travel(lived_only?)	居住和访问过的地点
search(query)	对以上所有内容进行关键词搜索

资源： resume://kgromero/json、resume://kgromero/markdown、resume://kgromero/site

提示词： assess_job_fit(job_description)：将简历与职位招聘信息进行对比。

在本地运行

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 / 其他客户端

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

设置

环境变量	默认值	用途
KGROMERO_SITE_URL	https://kgromero.com	指向其他部署，例如 http://localhost:5173
KGROMERO_OFFLINE	未设置	设为 1 以跳过网络并使用打包的快照

部署

该服务作为 kgromero-mcp 应用运行在 Fly.io 上（Dockerfile、fly.toml）。机器在空闲时停止，并在收到下一个请求时启动。kgromero.com/mcp 通过网站仓库中的路由（src/routes/mcp/+server.js）转发到 https://kgromero-mcp.fly.dev/mcp。

fly deploy --remote-only

发布

1. 更新 pyproject.toml 和 server.json 中两处的版本号。
2. 提交更改，然后运行 git tag vX.Y.Z && git push origin vX.Y.Z。

.github/workflows/publish.yml 会检查版本号是否与标签一致、运行测试、发布到 PyPI，然后更新 MCP Registry 条目。PyPI 使用可信发布（GitHub 环境 pypi），Registry 使用 GitHub OIDC，因此无需存储密钥。

开发

.venv/bin/pytest

测试使用快照离线运行。编辑网站后，可通过以下方式刷新快照：

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