DogPolicies

DogPolicies MCP 服务

dogpolicies.com · 加州和内华达州旅行的经核实犬只规则，供 AI 助手使用。安装指南和示例。

自 2026 年 11 月 4 日起列入 Claude 的连接器目录：在 Claude 中添加 DogPolicies，无需安装任何内容。DogPolicies 独立运营，与 Anthropic 无关联。

向 Claude、Cursor 或任何 MCP 客户端询问“我家 70 lb 的狗能住在每晚低于 $50 的蒙特雷酒店吗？”，“我的狗在卡梅尔可以做些什么？”或“规划一次带两只狗去太浩湖住三晚的行程”，即可获得附有官方来源、核查日期和记录链接的答案。无需 API 密钥、账号或配置：数据随软件包一同提供。

npx dogpolicies-mcp demo

能回答什么

• 2,400 多个公园、海滩、步道、酒店、露营地、小屋度假村和餐厅露台是否允许狗进入，以及牵绳规则、限制、体重上限和宠物费用。
• 哪家酒店愿意接待_你的_狗：体重、狗的数量、住宿晚数和费用预算，并列出费用计算过程（“2 只狗 x 3 晚 x 每只宠物每晚 $25 = $150，每次住宿最高收取 $100”）。
• 一次调用规划完整行程：在哪里住、带这只狗可以做什么、在哪里吃饭，地点可在任意城镇或县附近。
• 沿 I-5、US-101、Highway 1、I-15、I-80、US-50、US-95 和 US-93 的适犬停靠点，按行车顺序排列。在加州的 I-5 路段，每个停靠点都标注其距圣伊西德罗的 I-5 中心线距离（s 米）、所在侧、海拔和路段；并提供 N 英里内的下一个家庭设施停靠点（注明来源所述的洗手间和宠物区域）、配对出口，以及当前的 Caltrans 路况。
• 酒店连锁的宠物政策（Motel 6、Red Roof、Kimpton 等），以及哪些酒店是例外。
• 并排比较，以及某个日期以来的变化，可查询全区域或某个城镇附近。
• 按旅行者常用名称划分的区域：东湾、太浩湖、大苏尔、约塞米蒂、死亡谷、门多西诺海岸和湾区各大都会区；可作为筛选条件、near 和 plan_trip 中的地点名称，以及资源使用。

每条信息都来自官方来源（政府机构网页或商家的自有政策），并注明核查日期。每条结果都以一行引文开头，并以 DogPolicies, dogpolicies.com, CC BY 4.0, verified {date} 结尾。如果来源未说明某项信息，记录会标注“未说明”，而不是猜测。

安装

选择最适合你的方式；它们提供的 MCP 服务完全相同。

1. Claude（claude.ai 或 Claude Desktop）：添加托管连接器，无需安装

打开 Claude 连接器目录中的 DogPolicies 并添加，然后在聊天工具菜单中启用。也可以手动添加：Settings → Connectors → Add custom connector → 名称填 DogPolicies，URL 填 https://dogpolicies.com/mcp/ → Add。无需 Node.js，也无需编辑文件；所有提供连接器的套餐均可使用。

2. Claude Desktop：一键扩展

从最新版本下载 dogpolicies-mcp-.mcpb 并打开（双击，或在 Claude Desktop 中选择 Settings → Extensions → Install Extension）。数据已包含在其中；无需安装其他内容。

3. 一条命令，适用于任何客户端

npx dogpolicies-mcp install                      # Claude Desktop (default)
npx dogpolicies-mcp install --client cursor      # or vscode | windsurf | claude-code, or --all
npx dogpolicies-mcp install --hosted             # the remote URL form instead of a local server
npx dogpolicies-mcp install --dry-run            # show what would change, change nothing

它会在 Windows、macOS 和 Linux 上查找客户端配置；如果文件或 mcpServers 键不存在，则创建相应内容；合并一个条目，不改动其他设置；先创建带时间戳的备份；无法解析文件时会拒绝操作并说明原因；第二次运行时不做任何更改；无需管理员权限；并会打印确切的重启步骤。在 Windows 上，它会写入可用的格式（cmd /c npx ...）。需要 Node.js 20.19 或更高版本。

4. 一键按钮（托管服务，无需 Node.js）

两个按钮都会添加托管服务 https://dogpolicies.com/mcp/；客户端会请你确认。

5. Claude Code

claude mcp add dogpolicies -- npx -y dogpolicies-mcp                      # macOS, Linux
claude mcp add dogpolicies -- cmd /c npx -y dogpolicies-mcp               # Windows
claude mcp add --transport http dogpolicies https://dogpolicies.com/mcp/   # hosted, any OS

6. 手动配置

{
  "mcpServers": {
    "dogpolicies": { "command": "npx", "args": ["-y", "dogpolicies-mcp"] }
  }
}

code --add-mcp '{"name":"dogpolicies","type":"stdio","command":"npx","args":["-y","dogpolicies-mcp"]}'

本地 HTTP

npx dogpolicies-mcp --http --port 3737     # http://127.0.0.1:3737/mcp

故障排查

• 安装后未显示。 正确重启。必须完全退出 Claude Desktop：右键单击托盘图标（Windows），或选择 Claude 菜单 → Quit（macOS）；关闭窗口并不会让它退出。Cursor：在 Settings → MCP 中切换服务器。VS Code：MCP: List Servers → Start。Windsurf：在 MCP 面板中选择 Refresh。
• 检查服务本身。 npx dogpolicies-mcp check 会加载数据并调用每个工具；npx dogpolicies-mcp demo 会打印实际答复。如果这些命令能正常运行，问题就在客户端配置或重启上。
• 客户端日志位置。 Claude Desktop：%APPDATA%\Claude\logs\mcp.log 和 mcp-server-dogpolicies.log（Windows），~/Library/Logs/Claude/（macOS）。Cursor：Output 面板 → MCP Logs。VS Code：MCP: List Servers → Show Output。Claude Code：claude mcp list 或 --mcp-debug。
• Windows 上出现 “spawn npx ENOENT”。 客户端会在不使用 shell 的情况下启动命令，而 npx 是一个 .cmd 文件。请使用 "command": "cmd", "args": ["/c", "npx", "-y", "dogpolicies-mcp"]（安装程序会写入此配置），或使用托管连接器。
• Node 版本。 node --version 必须为 20.19 或更高版本（npx 随 Node 一起提供）。托管连接器和 Claude Desktop 扩展都不需要 Node（扩展使用 Claude Desktop 自带的 Node）。
• 在企业代理后运行。 npx 需要访问一次 registry.npmjs.org 以获取软件包；请设置 HTTPS_PROXY（npm 也会读取 npm config set proxy），或使用无需 npm 的扩展或托管连接器。服务本身会在后台向 dogpolicies.com 发出一次请求，以获取更新的数据；即使无法访问也能离线运行。设置 DOGPOLICIES_OFFLINE=1 可禁止它尝试连接。
• 仍然无法解决？ 请提交问题，并附上 npx dogpolicies-mcp check 的输出、你的操作系统和客户端：https://github.com/xultrax-web/dogpolicies-mcp/issues

在终端中试用

npx dogpolicies-mcp demo              # off-leash beaches near San Diego, with citations
npx dogpolicies-mcp demo "Monterey"   # hotels in Monterey for a 70 lb dog, 2 nights, fees worked out
npx dogpolicies-mcp check             # load the data and call every tool once

demo 的输出就是助手收到的原文：

- Coronado Dog Beach (Coronado, CA): Yes, with restrictions. Dogs may be off leash only on the
  designated Dog Beach area at 200 Ocean Boulevard ... Source: City of Coronado, checked
  2026-10-26. Record: https://dogpolicies.com/places/coronado-dog-beach/ (CC BY 4.0; cite with link).
  `coronado-dog-beach` · Coronado, San Diego County, California · 3 mi · freshness fresh

工具

资源和提示词

资源可让客户端无需调用工具即可附加记录：dogpolicies://place/{id}、dogpolicies://brand/{id}、dogpolicies://answer/{slug}、dogpolicies://route/{id}、dogpolicies://area/{id}（都支持补全），以及 dogpolicies://about、dogpolicies://answers、dogpolicies://status 和 dogpolicies://corridor/i-5（I-5 的路段及沿途所有停靠点，按 s 排序）。提示词会将常见行程添加到客户端的斜杠菜单中：plan_dog_trip、check_hotel_for_dog、road_trip_with_dog、drive_i5_with_dog、what_can_my_dog_do_here、cite_a_rule，并支持补全城镇名称。

数据如何保持最新

软件包附带一份带日期的快照（每个结果中的 as_of）。启动时会立即提供该快照，然后在后台检查 https://dogpolicies.com/data/mcp-snapshot-v1.json；如果存在更新版本，就会切换到新版本并将其缓存，以供下次使用。网站部署到该地址之前，这项检查会快速、静默地失败，软件包内置的数据会继续单独提供服务。设置 DOGPOLICIES_OFFLINE=1（或传入 --offline）可彻底禁用网络。所有选项见 docs/configuration.md。

隐私

• 不会收集任何信息。 不进行遥测、分析或崩溃报告；工具参数不会在高于 debug 的级别记录（输出到 stderr，也就是你的终端）。
• 离开你设备的信息： 启动时对数据快照发起一次条件 GET；仅当你使用 dogpolicies_report_correction 时，才会发送你输入的更正内容，以及你选择提供的可选联系方式。两者都通过 https 发送至 dogpolicies.com，不会发送到其他地方。--offline 会阻止这两种传输。
• 威胁模型和防护措施见 docs/security.md。

许可证和署名

• 代码： MIT。
• 数据： CC BY 4.0。署名时请使用“DogPolicies”，并链接至 https://dogpolicies.com/；引用每条记录时，请注明其 URL 和核验日期。每条结果都包含一行可直接使用的引用文本。连锁酒店的名称和地点来自 OpenStreetMap，遵循 ODbL 许可，且会在 record_license 中注明。
• 这些规则是有来源、注明日期的摘要，不构成法律建议。出行前请向相关机构或商家确认，尤其是记录标注为 stale、unreadable 或 inherited_brand 时。服务性动物受 ADA 管辖，不适用这些宠物规则。条款：https://dogpolicies.com/terms/

举报错误规则

告诉你的助手“那条规则不对”，它就可以通过 dogpolicies_report_correction 提交更正；你也可以使用任意记录页面上的表单。工作人员会重新查阅官方来源，通常会在一周内完成；记录的核验历史会显示处理结果。

面向开发者

import { createRuntime, createServer, connectInProcess } from "dogpolicies-mcp";

const ctx = createRuntime({ overrides: { offline: true } });
const { client, close } = await connectInProcess(ctx);
const r = await client.callTool({
  name: "dogpolicies_plan_trip",
  arguments: { place: "Monterey", dog_weight_lb: 70, nights: 3 },
});
console.log(r.content[0].text);
await close();

createServer(ctx) 会为任意传输方式返回一个来自官方 @modelcontextprotocol/server SDK 的 McpServer。可复用且不依赖狗狗相关内容的核心（dogpolicies-mcp/core），以及如何基于它构建另一个服务：docs/architecture.md。版本管理和弃用说明：docs/versioning.md。贡献指南：CONTRIBUTING.md。

测试：npm test 会运行单元、契约、安全、性能、表面、评估（针对工具选择和回答事实评分的 33 个真实问题）及模糊测试；npm run test:e2e 会打包 tarball 并通过 stdio 运行。CI 会在 Linux、macOS 和 Windows 上使用 Node 20、22 和 24 运行。