areaguide

areaguide

ikeytz maps read/link 服务的转发客户端——这是 Ludwigsburg 一家锁匠服务区域网站背后的公开只读服务。 它涵盖该网站的服务区域、地点、地理和页面数据，以及链接生成器。

areaguide 本身不包含地图逻辑。它根据上游服务器 68 个工具的原样捕获数据（名称、标题、描述和 inputSchema；不复现捕获数据中的 outputSchema 字段和注释），在本地提供 tools/list，并将每个 tools/call 转发到上游端点。上游结果原样透传；转发失败时，会返回文本结果 areaguide error: ...，并将 isError 设为 true。

上游

• 默认端点：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 — 版权所有 (c) 2026 Rene Turcios。