dogpolicies-mcp 0.2.3 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +33 -0
- package/README.md +62 -37
- package/bin/dogpolicies-mcp.mjs +21 -1
- package/data/snapshot.json.gz +0 -0
- package/docs/tools.md +129 -134
- package/package.json +4 -2
- package/server.json +8 -2
- package/src/config.mjs +3 -4
- package/src/dogpolicies/install.mjs +431 -0
- package/src/dogpolicies/mcpb-manifest.mjs +87 -0
- package/src/dogpolicies/server.mjs +3 -1
package/CHANGELOG.md
CHANGED
|
@@ -10,6 +10,39 @@ The data inside the package has its own date (`as_of` in every result). A
|
|
|
10
10
|
new package version ships a new snapshot; the server also refreshes from the
|
|
11
11
|
site on its own when the network allows.
|
|
12
12
|
|
|
13
|
+
## 0.2.5 - 2026-11-01
|
|
14
|
+
|
|
15
|
+
The install experience, after a hand install into Claude Desktop on Windows
|
|
16
|
+
needed finding the config file, adding a missing `mcpServers` key, merging,
|
|
17
|
+
backing up and a full quit from the tray.
|
|
18
|
+
|
|
19
|
+
Added
|
|
20
|
+
|
|
21
|
+
- `npx dogpolicies-mcp install` with `--client claude-desktop | cursor |
|
|
22
|
+
vscode | windsurf | claude-code`, `--all`, `--hosted`, `--dry-run` and
|
|
23
|
+
`--uninstall`: finds the client's config on Windows, macOS and Linux,
|
|
24
|
+
creates the file or the `mcpServers` key when missing, merges one entry
|
|
25
|
+
without touching other settings, writes a timestamped backup, is
|
|
26
|
+
idempotent, refuses (and explains) a file it cannot parse, needs no admin
|
|
27
|
+
rights, and prints the exact restart step and log location. On Windows it
|
|
28
|
+
writes `cmd /c npx -y dogpolicies-mcp`, the form clients can start.
|
|
29
|
+
Claude Code goes through the official `claude mcp add`.
|
|
30
|
+
- A one-click Claude Desktop extension (`dogpolicies-mcp-<version>.mcpb`,
|
|
31
|
+
official MCPB format, manifest 0.3, built with the official CLI) attached
|
|
32
|
+
to every GitHub release by the publish workflow. `npm run mcpb` builds it.
|
|
33
|
+
- Add to Cursor and Install in VS Code buttons (hosted server), and an
|
|
34
|
+
install order that puts the no-install connector first.
|
|
35
|
+
- A troubleshooting section: restarting properly, `check`, where each
|
|
36
|
+
client's logs are, Node version, the Windows npx note, corporate proxies.
|
|
37
|
+
|
|
38
|
+
## 0.2.4 - 2026-10-31
|
|
39
|
+
|
|
40
|
+
- The registry listing names the hosted server, https://dogpolicies.com/mcp/, now that the site is live on Cloudflare.
|
|
41
|
+
|
|
42
|
+
- Bundler-friendly for other runtimes: `package.json` is read with a static JSON import and the bundled snapshot
|
|
43
|
+
path is only resolved when `import.meta.url` exists. No change for npm users; the site's Cloudflare Worker now
|
|
44
|
+
runs this package inside a Durable Object.
|
|
45
|
+
|
|
13
46
|
## 0.2.3 - 2026-10-31
|
|
14
47
|
|
|
15
48
|
- Smaller, cleaner install: the MCP client SDK is no longer a dependency. `demo`, `check` and `connectInProcess` use a small built-in client over the in-memory transport. The client SDK pulled in process-spawning and other code a server never runs, which supply-chain scanners flag.
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# DogPolicies MCP server
|
|
2
2
|
|
|
3
|
-
**[dogpolicies.com](https://dogpolicies.com/)** · Verified dog rules for California and Nevada travel, for AI assistants.
|
|
3
|
+
**[dogpolicies.com](https://dogpolicies.com/)** · Verified dog rules for California and Nevada travel, for AI assistants. [Install guide and example](https://dogpolicies.com/mcp/about/).
|
|
4
4
|
|
|
5
5
|
Ask Claude, Cursor or any MCP client "can my 70 lb dog stay at a Monterey hotel for under $50?", "what can my dog do in Carmel?" or "plan three nights in Tahoe with two dogs" and get an answer with the official source, the date it was checked and a link to the record. No API key, no account, no configuration: the data ships inside the package.
|
|
6
6
|
|
|
@@ -30,73 +30,98 @@ Every fact comes from an official source (an agency page or the business's own p
|
|
|
30
30
|
|
|
31
31
|
## Install
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
Pick the first one that fits; they all give the same server.
|
|
34
|
+
|
|
35
|
+
### 1. Claude (claude.ai or Claude Desktop): add the hosted connector, nothing to install
|
|
36
|
+
|
|
37
|
+
Settings → Connectors → **Add custom connector** → name **DogPolicies**, URL `https://dogpolicies.com/mcp/` → Add. Then turn it on in the chat's tools menu. No Node.js, no file editing; works on every plan that has connectors.
|
|
38
|
+
|
|
39
|
+
### 2. Claude Desktop: one-click extension
|
|
40
|
+
|
|
41
|
+
Download **dogpolicies-mcp-<version>.mcpb** from the [latest release](https://github.com/xultrax-web/dogpolicies-mcp/releases/latest) and open it (double-click, or Claude Desktop → Settings → Extensions → Install Extension). The data is inside; nothing else to install.
|
|
42
|
+
|
|
43
|
+
### 3. One command, any client
|
|
34
44
|
|
|
35
45
|
```bash
|
|
36
|
-
|
|
46
|
+
npx dogpolicies-mcp install # Claude Desktop (default)
|
|
47
|
+
npx dogpolicies-mcp install --client cursor # or vscode | windsurf | claude-code, or --all
|
|
48
|
+
npx dogpolicies-mcp install --hosted # the remote URL form instead of a local server
|
|
49
|
+
npx dogpolicies-mcp install --dry-run # show what would change, change nothing
|
|
37
50
|
```
|
|
38
51
|
|
|
39
|
-
|
|
52
|
+
It finds the client's config on Windows, macOS and Linux, creates the file or the `mcpServers` key if missing, merges one entry without touching other settings, writes a timestamped backup first, refuses (and explains) a file it cannot parse, does nothing the second time, needs no admin rights, and prints the exact restart step. On Windows it writes the form that works (`cmd /c npx ...`). Requires Node.js 20.19 or newer.
|
|
40
53
|
|
|
41
|
-
|
|
54
|
+
### 4. One-click buttons (hosted server, no Node.js)
|
|
42
55
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
56
|
+
[](cursor://anysphere.cursor-deeplink/mcp/install?name=dogpolicies&config=eyJ1cmwiOiJodHRwczovL2RvZ3BvbGljaWVzLmNvbS9tY3AvIn0=)
|
|
57
|
+
[](vscode:mcp/install?%7B%22name%22%3A%22dogpolicies%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdogpolicies.com%2Fmcp%2F%22%7D)
|
|
58
|
+
[](vscode-insiders:mcp/install?%7B%22name%22%3A%22dogpolicies%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdogpolicies.com%2Fmcp%2F%22%7D)
|
|
59
|
+
|
|
60
|
+
Both buttons add the hosted server at `https://dogpolicies.com/mcp/`; the client asks you to confirm.
|
|
61
|
+
|
|
62
|
+
### 5. Claude Code
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
claude mcp add dogpolicies -- npx -y dogpolicies-mcp # macOS, Linux
|
|
66
|
+
claude mcp add dogpolicies -- cmd /c npx -y dogpolicies-mcp # Windows
|
|
67
|
+
claude mcp add --transport http dogpolicies https://dogpolicies.com/mcp/ # hosted, any OS
|
|
52
68
|
```
|
|
53
69
|
|
|
54
|
-
###
|
|
70
|
+
### 6. By hand
|
|
55
71
|
|
|
56
|
-
|
|
72
|
+
<details><summary>Claude Desktop</summary>
|
|
73
|
+
|
|
74
|
+
Settings → Developer → Edit Config (the file is `%APPDATA%\Claude\claude_desktop_config.json` on Windows, `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS). If the file has no `mcpServers` key yet, add one:
|
|
57
75
|
|
|
58
76
|
```json
|
|
59
77
|
{
|
|
60
78
|
"mcpServers": {
|
|
61
|
-
"dogpolicies": {
|
|
62
|
-
"command": "npx",
|
|
63
|
-
"args": ["-y", "dogpolicies-mcp"]
|
|
64
|
-
}
|
|
79
|
+
"dogpolicies": { "command": "npx", "args": ["-y", "dogpolicies-mcp"] }
|
|
65
80
|
}
|
|
66
81
|
}
|
|
67
82
|
```
|
|
68
83
|
|
|
69
|
-
|
|
84
|
+
On Windows use `"command": "cmd", "args": ["/c", "npx", "-y", "dogpolicies-mcp"]`. Then fully quit Claude Desktop (tray icon → Quit on Windows, Cmd+Q on macOS) and reopen it.
|
|
70
85
|
|
|
71
|
-
|
|
86
|
+
</details>
|
|
72
87
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
"dogpolicies": {
|
|
77
|
-
"type": "stdio",
|
|
78
|
-
"command": "npx",
|
|
79
|
-
"args": ["-y", "dogpolicies-mcp"]
|
|
80
|
-
}
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
```
|
|
88
|
+
<details><summary>Cursor</summary>
|
|
89
|
+
|
|
90
|
+
`~/.cursor/mcp.json` (global) or `.cursor/mcp.json` in a project, same `mcpServers` block as above (Windows: the `cmd /c` form), or `{ "url": "https://dogpolicies.com/mcp/" }` for the hosted server.
|
|
84
91
|
|
|
85
|
-
|
|
92
|
+
</details>
|
|
86
93
|
|
|
87
|
-
|
|
94
|
+
<details><summary>VS Code</summary>
|
|
95
|
+
|
|
96
|
+
`~/.copilot/mcp-config.json` (what the guided flow calls Global → Copilot Global) with the same `mcpServers` block, or from a terminal:
|
|
88
97
|
|
|
89
98
|
```bash
|
|
90
|
-
|
|
99
|
+
code --add-mcp '{"name":"dogpolicies","type":"stdio","command":"npx","args":["-y","dogpolicies-mcp"]}'
|
|
91
100
|
```
|
|
92
101
|
|
|
102
|
+
</details>
|
|
103
|
+
|
|
104
|
+
<details><summary>Windsurf</summary>
|
|
105
|
+
|
|
106
|
+
`~/.codeium/windsurf/mcp_config.json`, same `mcpServers` block, or `{ "serverUrl": "https://dogpolicies.com/mcp/" }`.
|
|
107
|
+
|
|
108
|
+
</details>
|
|
109
|
+
|
|
93
110
|
### Local HTTP
|
|
94
111
|
|
|
95
112
|
```bash
|
|
96
113
|
npx dogpolicies-mcp --http --port 3737 # http://127.0.0.1:3737/mcp
|
|
97
114
|
```
|
|
98
115
|
|
|
99
|
-
|
|
116
|
+
## Troubleshooting
|
|
117
|
+
|
|
118
|
+
- **It does not show up after installing.** Restart properly. Claude Desktop must be fully quit: right-click the tray icon (Windows) or Claude menu → Quit (macOS); closing the window leaves it running. Cursor: toggle the server in Settings → MCP. VS Code: MCP: List Servers → Start. Windsurf: Refresh in the MCP panel.
|
|
119
|
+
- **Check the server itself.** `npx dogpolicies-mcp check` loads the data and calls every tool; `npx dogpolicies-mcp demo` prints a real answer. If these work, the problem is the client's config or restart.
|
|
120
|
+
- **Where the client's logs are.** Claude Desktop: `%APPDATA%\Claude\logs\mcp.log` and `mcp-server-dogpolicies.log` (Windows), `~/Library/Logs/Claude/` (macOS). Cursor: Output panel → MCP Logs. VS Code: MCP: List Servers → Show Output. Claude Code: `claude mcp list`, or `--mcp-debug`.
|
|
121
|
+
- **"spawn npx ENOENT" on Windows.** The client starts commands without a shell and `npx` is a `.cmd` file. Use `"command": "cmd", "args": ["/c", "npx", "-y", "dogpolicies-mcp"]` (the installer writes this), or the hosted connector.
|
|
122
|
+
- **Node version.** `node --version` must be 20.19 or newer (`npx` comes with Node). The hosted connector and the Claude Desktop extension need no Node at all (the extension uses Claude Desktop's own).
|
|
123
|
+
- **Behind a corporate proxy.** `npx` needs to reach registry.npmjs.org once to fetch the package; set `HTTPS_PROXY` (npm reads `npm config set proxy` too) or use the extension or the hosted connector, which need no npm. The server itself makes one background request to dogpolicies.com for newer data and works offline without it; set `DOGPOLICIES_OFFLINE=1` to never try.
|
|
124
|
+
- **Still stuck?** Open an issue with the output of `npx dogpolicies-mcp check`, your OS and client: https://github.com/xultrax-web/dogpolicies-mcp/issues
|
|
100
125
|
|
|
101
126
|
## Try it in the terminal
|
|
102
127
|
|
package/bin/dogpolicies-mcp.mjs
CHANGED
|
@@ -27,6 +27,9 @@ Usage
|
|
|
27
27
|
${PACKAGE_NAME} --http [--port N] serve over Streamable HTTP on localhost
|
|
28
28
|
${PACKAGE_NAME} demo [query] print one cited answer to the terminal
|
|
29
29
|
${PACKAGE_NAME} check load the data and call every tool once
|
|
30
|
+
${PACKAGE_NAME} install add this server to Claude Desktop (or --client cursor |
|
|
31
|
+
vscode | windsurf | claude-code, or --all); --hosted for the
|
|
32
|
+
remote URL, --dry-run to preview, --uninstall to remove
|
|
30
33
|
${PACKAGE_NAME} --version | --help
|
|
31
34
|
|
|
32
35
|
Options
|
|
@@ -48,6 +51,13 @@ function parseArgs(argv) {
|
|
|
48
51
|
host: "127.0.0.1",
|
|
49
52
|
overrides: {},
|
|
50
53
|
rest: [],
|
|
54
|
+
install: {
|
|
55
|
+
clients: [],
|
|
56
|
+
hosted: false,
|
|
57
|
+
dryRun: false,
|
|
58
|
+
uninstall: false,
|
|
59
|
+
all: false,
|
|
60
|
+
},
|
|
51
61
|
};
|
|
52
62
|
for (let i = 0; i < argv.length; i++) {
|
|
53
63
|
const a = argv[i];
|
|
@@ -56,7 +66,12 @@ function parseArgs(argv) {
|
|
|
56
66
|
else if (a === "--version" || a === "-v") out.command = "version";
|
|
57
67
|
else if (a === "--http") out.command = "http";
|
|
58
68
|
else if (a === "--stdio") out.command = "stdio";
|
|
59
|
-
else if (a === "demo" || a === "check") out.command = a;
|
|
69
|
+
else if (a === "demo" || a === "check" || a === "install") out.command = a;
|
|
70
|
+
else if (a === "--client") out.install.clients.push(next());
|
|
71
|
+
else if (a === "--hosted") out.install.hosted = true;
|
|
72
|
+
else if (a === "--dry-run") out.install.dryRun = true;
|
|
73
|
+
else if (a === "--uninstall") out.install.uninstall = true;
|
|
74
|
+
else if (a === "--all") out.install.all = true;
|
|
60
75
|
else if (a === "--offline") out.overrides.offline = true;
|
|
61
76
|
else if (a === "--base-url") out.overrides.baseUrl = next();
|
|
62
77
|
else if (a === "--log") out.overrides.logLevel = next();
|
|
@@ -76,6 +91,11 @@ if (args.command === "help") {
|
|
|
76
91
|
process.stdout.write(HELP);
|
|
77
92
|
process.exit(0);
|
|
78
93
|
}
|
|
94
|
+
if (args.command === "install") {
|
|
95
|
+
// Needs no data and no server: only the client's config file.
|
|
96
|
+
const { runInstall } = await import("../src/dogpolicies/install.mjs");
|
|
97
|
+
process.exit(runInstall(args.install));
|
|
98
|
+
}
|
|
79
99
|
if (args.command === "version") {
|
|
80
100
|
process.stdout.write(`${PACKAGE_VERSION}\n`);
|
|
81
101
|
process.exit(0);
|
package/data/snapshot.json.gz
CHANGED
|
Binary file
|