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 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
- ### Claude Code
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
- claude mcp add dogpolicies -- npx -y dogpolicies-mcp
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
- ### Claude Desktop
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
- Settings → Developer → Edit Config, then add:
54
+ ### 4. One-click buttons (hosted server, no Node.js)
42
55
 
43
- ```json
44
- {
45
- "mcpServers": {
46
- "dogpolicies": {
47
- "command": "npx",
48
- "args": ["-y", "dogpolicies-mcp"]
49
- }
50
- }
51
- }
56
+ [![Add to Cursor](https://img.shields.io/badge/Cursor-Add_DogPolicies-000000?logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=dogpolicies&config=eyJ1cmwiOiJodHRwczovL2RvZ3BvbGljaWVzLmNvbS9tY3AvIn0=)
57
+ [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_DogPolicies-0098FF?logo=visualstudiocode&logoColor=white)](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
+ [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_DogPolicies-24bfa5?logo=visualstudiocode&logoColor=white)](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
- ### Cursor
70
+ ### 6. By hand
55
71
 
56
- Settings → MCP → Add new global MCP server (or `.cursor/mcp.json` in a project):
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
- ### VS Code
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
- `.vscode/mcp.json` in a workspace, or **MCP: Add Server** from the command palette:
86
+ </details>
72
87
 
73
- ```json
74
- {
75
- "servers": {
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
- ### Hosted (no install)
92
+ </details>
86
93
 
87
- Once the site is live, the same tools are served over Streamable HTTP at `https://dogpolicies.com/mcp/` for clients that connect by URL:
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
- claude mcp add --transport http dogpolicies https://dogpolicies.com/mcp/
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
- Requires Node.js 20.19 or newer.
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
 
@@ -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);
Binary file