siteguide

siteguide

ikeytz ウェブサイトの読み取り／リンクサービス向け転送クライアントです。Ludwigsburg の鍵屋のメインウェブサイトを支える、公開読み取り専用サービスです。このサイトのサービス、固定料金、対応エリア、FAQ エントリー、ナレッジ記事とガイド、ディスカバリーファイル、リンク作成機能を対象としています。

siteguide 自体にはウェブサイトのロジックはありません。上流サーバーの47個のツール（name、title、description、inputSchema。キャプチャに含まれる outputSchema フィールドと annotations は再現されません）をそのまま記録したデータから、ローカルで tools/list を提供し、すべての tools/call を上流エンドポイントに転送します。上流の結果は変更せずに返されます。転送に失敗した場合は、isError が設定された siteguide error: ... テキスト結果が返されます。

上流

• デフォルトのエンドポイント：https://www.ikeytz.com/mcp
• 変更するには、IKEYTZ_WEBSITE_MCP_URL に別のストリーミング可能な HTTP MCP エンドポイントを設定します。（上書き先は再構築版です。デフォルトのエンドポイントは固定されています。）
• アカウントも API キーも不要です。
• 転送時には initialize（protocolVersion 2025-03-26、clientInfo siteguide / 0.1.0）、続いて notifications/initialized、その後 tools/call を実行し、上流から発行された場合は Mcp-Session-Id ヘッダーを尊重します。応答は通常の JSON またはサーバー送信イベントの場合があります。

CLI の使用方法

npx @reneturcios/siteguide get_service_area '{"slug":"pattonville"}'
npx @reneturcios/siteguide site_overview '{}'
npx @reneturcios/siteguide --version

各ツールのサブコマンドは単一の JSON 引数文字列を受け取り、呼び出しを転送して結果を JSON として出力します。終了コード：成功の場合は 0、転送した呼び出しでエラーが発生した場合は 1、使用方法に誤りがある場合は 2 です。

MCP の使用方法

npx @reneturcios/siteguide mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "siteguide": {
      "command": "npx",
      "args": ["-y", "@reneturcios/siteguide", "mcp"]
    }
  }
}

不明なツール名や、JSON オブジェクトではない引数は、ネットワークに接続する前にローカルで InvalidParams として拒否されます。

Docker

docker run -i ghcr.io/cloudcorprecords/siteguide          # stdio MCP server (CMD defaults to "mcp")
docker run --rm ghcr.io/cloudcorprecords/siteguide get_service_area '{"slug":"pattonville"}'

ツール（47個）

site_overview、get_business_identity、list_nav、 list_footer、list_locales、resolve_locale_url、get_prices、 get_ort_datetime、get_invoice_line_items、list_services、 get_emergency、list_auswahl、get_auswahl_item、 list_service_areas、get_service_area、get_geo_office、 get_contact、get_legal、get_about、get_partner_info、 get_links、get_it、get_mcp_hub、get_review_url、 list_faq、get_faq、list_wissen、get_wissen_entry、 list_ratgeber、get_ratgeber、get_page_summary、 get_ai_page、get_serp_snippet、find_by_keyword、 get_discovery、get_llms_txt、get_llms_jsonld、 get_llms_serp_txt、get_llms_mcp_server、get_llms_mcp_web、 get_ai_txt、get_sitemap_txt、list_whatsapp_options、 compose_tel_mobile、compose_tel_landline、compose_whatsapp、 compose_mailto。

開発

npm install
npm run build   # tsc -> dist/ (dist/cli.js is the bin)
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # tsx src/cli.ts

ライセンス

MIT — 著作権 (c) 2026 Rene Turcios。