siteguide

Name: siteguide
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 siteguide

siteguide 是用于读取和链接 ikeytz 锁匠网站内容的转发型 MCP 服务，提供 47 个工具，涵盖服务、价格、区域、常见问题和指南；它本身不保存网站数据。

主要功能

01提供 47 个网站内容工具
02查询服务、价格和区域
03查找常见问题与指南
04生成链接和联系方式

适用场景

01查询锁匠服务区域和价格
02从常见问题与指南中查找答案
03生成网站联系链接

MCP 相关

它向 MCP 客户端提供 ikeytz 网站服务的工具，并将工具调用转发到上游 MCP 端点。工具定义取自本地保存的工具列表。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @reneturcios/siteguide

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/siteguide0.1.0stdio

ocighcr.io/cloudcorprecords/siteguide:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
locale	enum	否	canonicalUrl 和路径前缀使用的 HTML 语言区域。de = 默认值，URL 不带前缀（https://www.ikeytz.com/preise）。en\|fr\|ru\|fa\|ar\|tr = 使用前缀 /{locale}/（https://www.ikeytz.com/en/preise）。省略或留空 = de。不改变价格、电话号码或德语法定名称。不是 maps.ikeytz.com 的语言区域（maps 仅支持德语）。de \| en \| fr \| ru \| fa \| ar \| tr

详细介绍

siteguide

用于转发 ikeytz 网站读取／链接服务的客户端——该公开、只读服务位于一家 Ludwigsburg 锁匠公司的主网站之后。它涵盖该网站的服务、固定价格、服务区域、常见问题条目、知识文章和指南、发现文件以及链接构造器。

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

上游

默认端点：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