areaguide

areaguide

ikeytz の地図読み取り／リンクサービス向け転送クライアントです。ルートヴィヒスブルクの鍵屋が運営するサービス提供地域サイトの背後にある、公開読み取り専用サービスです。 このサイトのサービス提供地域、場所、地理情報、ページデータ、リンク作成機能を利用できます。

areaguide 自体は地図関連のロジックを持ちません。上流サーバーの 68 個のツールの完全なキャプチャ（名前、タイトル、説明、inputSchema。キャプチャの outputSchema フィールドとアノテーションは再現されません）を使って、tools/list をローカルで提供し、すべての tools/call を上流エンドポイントに転送します。上流の結果は変更せずに返されます。転送に失敗すると、isError が設定された areaguide error: ... というテキスト結果が返されます。

上流

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

CLI の使用方法

npx @reneturcios/areaguide get_service_area '{"slug":"ludwigsburg"}'
npx @reneturcios/areaguide list_service_areas '{}'
npx @reneturcios/areaguide --version

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

MCP の使用方法

npx @reneturcios/areaguide mcp

MCP クライアントの設定：

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

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

Docker

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

ツール（68）

list_service_areas、get_service_area、get_ort_datetime、 get_geo_office、get_contact、get_discovery、get_llms_mcp_server、 get_llms_mcp_web、find_by_keyword、find_by_serp、 get_serp_snippet、find_by_plz、find_by_geo、find_by_icbm、 find_by_gebiet、find_by_area、list_slugs、list_plz、get_hub、 get_embed_map、get_geo_api、get_grenze、get_grenze_koordinaten、 get_lage、get_geschichte、distance_to_office、resolve_maps_url、 find_by_google_maps、get_legal、get_urheberrecht、get_copyright、 get_impressum、get_agb、get_nutzungsbedingungen、get_datenschutz、 get_widerruf、site_overview、get_business_identity、list_nav、 list_footer、list_locales、resolve_locale_url、get_prices、 get_invoice_line_items、list_services、get_emergency、 list_auswahl、get_auswahl_item、get_about、get_partner_info、 get_links、get_review_url、list_faq、get_faq、list_wissen、 get_wissen_entry、list_ratgeber、get_ratgeber、get_page_summary、 get_ai_page、get_llms_txt、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 — Copyright (c) 2026 Rene Turcios.