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 として登録されています。

仕組み

データは稼働中のサイトから取得され、1 時間キャッシュされます。

• 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 に設定すると、ネットワークへのアクセスを省略し、同梱のスナップショットを使用します

デプロイ

Fly.io 上で kgromero-mcp アプリとして実行されます（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 か所でバージョンを更新します。
2. コミットし、git tag vX.Y.Z && git push origin vX.Y.Z を実行します。

.github/workflows/publish.yml は、バージョンがタグと一致することを確認し、テストを実行して PyPI に公開した後、MCP Registry の登録情報を更新します。PyPI では信頼された公開（GitHub の環境 pypi）を使用し、レジストリでは 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