dogpolicies-mcp 0.2.4 → 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 +25 -0
- package/README.md +62 -37
- package/bin/dogpolicies-mcp.mjs +21 -1
- package/docs/tools.md +129 -134
- package/package.json +4 -2
- package/server.json +2 -2
- package/src/dogpolicies/install.mjs +431 -0
- package/src/dogpolicies/mcpb-manifest.mjs +87 -0
package/CHANGELOG.md
CHANGED
|
@@ -10,6 +10,31 @@ 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
|
+
|
|
13
38
|
## 0.2.4 - 2026-10-31
|
|
14
39
|
|
|
15
40
|
- The registry listing names the hosted server, https://dogpolicies.com/mcp/, now that the site is live on Cloudflare.
|
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/docs/tools.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Tool reference
|
|
2
2
|
|
|
3
|
-
dogpolicies-mcp 0.2.
|
|
3
|
+
dogpolicies-mcp 0.2.5, generated by `node scripts/docs.mjs` from the live definitions. Every tool returns readable markdown by default and structured JSON with `response_format: "json"`; every result starts with a citation and ends with the attribution line.
|
|
4
4
|
|
|
5
5
|
## `dogpolicies_search_places`
|
|
6
6
|
|
|
@@ -11,7 +11,6 @@ Search parks, beaches, trails, hotels, campgrounds and cabin resorts in Californ
|
|
|
11
11
|
Returns one page of places with a one-line answer ("Yes, on a leash no longer than 6 feet."), status (yes, yes_restricted, no, varies), verification date and page URL. Use dogpolicies_get_place for full rules and sources, and dogpolicies_find_hotels to check a specific dog's weight and budget at hotels.
|
|
12
12
|
|
|
13
13
|
Examples:
|
|
14
|
-
|
|
15
14
|
- "Off-leash beaches near San Diego" -> type="beach", off_leash=true, near={lat:32.72, lon:-117.16}
|
|
16
15
|
- "Can I bring my dog to Point Lobos?" -> query="Point Lobos"
|
|
17
16
|
- "State parks in Marin County that allow dogs" -> type="park", county="Marin", dogs_allowed=true
|
|
@@ -23,20 +22,20 @@ Examples:
|
|
|
23
22
|
|
|
24
23
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
25
24
|
|
|
26
|
-
| Input
|
|
27
|
-
|
|
28
|
-
| `query`
|
|
29
|
-
| `type`
|
|
30
|
-
| `dogs_allowed`
|
|
31
|
-
| `off_leash`
|
|
32
|
-
| `state`
|
|
33
|
-
| `county`
|
|
34
|
-
| `region`
|
|
35
|
-
| `area`
|
|
36
|
-
| `near`
|
|
37
|
-
| `limit`
|
|
38
|
-
| `offset`
|
|
39
|
-
| `response_format` | `markdown`, `json` (default `"markdown"`)
|
|
25
|
+
| Input | Type | Meaning |
|
|
26
|
+
|---|---|---|
|
|
27
|
+
| `query` | string (min length 2, max length 100) | Words to match in the name, city, county or brand |
|
|
28
|
+
| `type` | `lodging`, `campground`, `cabins`, `beach`, `park`, `trail`, `restaurant` | Kind of place; campground covers campgrounds and RV parks (some also rent cabins), cabins covers cabin resorts with no campground, restaurant covers restaurants, cafes, bars, breweries and tasting rooms (dogs on the patio, by the owner's published policy) |
|
|
29
|
+
| `dogs_allowed` | boolean | true: only places that allow dogs somewhere; false: only places that do not |
|
|
30
|
+
| `off_leash` | boolean | true: only places where the managing agency allows dogs off leash, at least at some times |
|
|
31
|
+
| `state` | `CA`, `NV` | "CA" or "NV". Also tells apart counties with the same name, such as Humboldt. |
|
|
32
|
+
| `county` | string (min length 2, max length 40) | County name without "County", in California or Nevada, e.g. "Monterey" or "Washoe" |
|
|
33
|
+
| `region` | `north-coast`, `shasta-cascade`, `gold-country`, `high-sierra`, `bay-area`, `central-coast`, `central-valley`, `inland-empire-deserts`, `los-angeles`, `orange-county`, `san-diego`, `reno-tahoe-nevada`, `las-vegas-southern-nevada`, `northern-central-nevada` | Region id, e.g. central-coast, san-diego or reno-tahoe-nevada |
|
|
34
|
+
| `area` | string (min length 2, max length 60) | Area id, the name a traveler gives the trip: san-francisco, east-bay, peninsula, south-bay, north-bay, lake-tahoe, big-sur, mendocino-coast, yosemite, death-valley |
|
|
35
|
+
| `near` | object | Limit to places near a point; results are sorted by distance |
|
|
36
|
+
| `limit` | integer (min 1, max 50, default `10`) | Maximum results to return |
|
|
37
|
+
| `offset` | integer (min 0, max 9007199254740991, default `0`) | Results to skip, for pagination |
|
|
38
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
40
39
|
|
|
41
40
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `total`, `count`, `offset`, `has_more`, `places` (more may be added; none removed).
|
|
42
41
|
|
|
@@ -49,22 +48,21 @@ Anything for dogs around a town, county or point: everything dog-related nearby,
|
|
|
49
48
|
Takes a town or county name (no coordinates needed) or a point. Use dogpolicies_find_hotels when the question is about a specific dog's weight or budget, dogpolicies_plan_trip for a whole stay, dogpolicies_search_places for one kind with filters.
|
|
50
49
|
|
|
51
50
|
Examples:
|
|
52
|
-
|
|
53
51
|
- "What can my dog do in Carmel?" -> place="Carmel"
|
|
54
52
|
- "Dog beaches and parks around South Lake Tahoe" -> place="South Lake Tahoe", types=["beach","park"]
|
|
55
53
|
- "Anything dog-friendly within 5 miles of here" -> near={lat:36.6, lon:-121.9}, radius_miles=5
|
|
56
54
|
|
|
57
55
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
58
56
|
|
|
59
|
-
| Input
|
|
60
|
-
|
|
61
|
-
| `place`
|
|
62
|
-
| `near`
|
|
63
|
-
| `radius_miles`
|
|
64
|
-
| `types`
|
|
65
|
-
| `dogs_allowed_only` | boolean (default `true`)
|
|
66
|
-
| `per_type`
|
|
67
|
-
| `response_format`
|
|
57
|
+
| Input | Type | Meaning |
|
|
58
|
+
|---|---|---|
|
|
59
|
+
| `place` | string (min length 2, max length 80) | A city, county or area in California or Nevada, e.g. "Monterey", "South Lake Tahoe", "Washoe County, NV", "Las Vegas", "East Bay" or "Lake Tahoe" |
|
|
60
|
+
| `near` | object | A point instead of a town; give one of place or near |
|
|
61
|
+
| `radius_miles` | number (min 1, max 100, default `15`) | Search radius in miles around the town or point (an area is its own boundary; the radius is ignored) |
|
|
62
|
+
| `types` | array of `beach`, `park`, `trail`, `lodging`, `campground`, `cabins`, `restaurant`, `rest_area`, `stop` | Kinds to include; all by default |
|
|
63
|
+
| `dogs_allowed_only` | boolean (default `true`) | Leave out places where dogs are not allowed |
|
|
64
|
+
| `per_type` | integer (min 1, max 20, default `5`) | Nearest results to show per kind |
|
|
65
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
68
66
|
|
|
69
67
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `center`, `label`, `radius_miles`, `total`, `groups` (more may be added; none removed).
|
|
70
68
|
|
|
@@ -78,9 +76,9 @@ Use after dogpolicies_search_places or dogpolicies_find_hotels, which return ids
|
|
|
78
76
|
|
|
79
77
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
80
78
|
|
|
81
|
-
| Input
|
|
82
|
-
|
|
83
|
-
| `id` (required)
|
|
79
|
+
| Input | Type | Meaning |
|
|
80
|
+
|---|---|---|
|
|
81
|
+
| `id` (required) | string (min length 2, max length 120) | Place id, e.g. "fort-funston" |
|
|
84
82
|
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
85
83
|
|
|
86
84
|
Output fields: `id`, `uid`, `name`, `type`, `status`, `answer`, `citation`, `confidence`, `confirmed_by`, `freshness`, `verified_at`, `url`, `source_urls`, `record_license`, `as_of`, `license`, `attribution_text`, `attribution_url`, `facts`, `rule_records`, `not_stated`, `rules`, `sources`, `review_due` (more may be added; none removed).
|
|
@@ -95,9 +93,9 @@ Use after a search returned candidates and the user asks "which one?". Ids come
|
|
|
95
93
|
|
|
96
94
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
97
95
|
|
|
98
|
-
| Input
|
|
99
|
-
|
|
100
|
-
| `ids` (required)
|
|
96
|
+
| Input | Type | Meaning |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| `ids` (required) | array of string | Two to six place ids from search results |
|
|
101
99
|
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
102
100
|
|
|
103
101
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `places`, `rows` (more may be added; none removed).
|
|
@@ -111,26 +109,25 @@ Plan a stay in a California or Nevada town with a dog, in one call: where to sta
|
|
|
111
109
|
Give the town or county and the dog: weight, how many dogs, nights, and the most the user will pay in pet fees. Use dogpolicies_route_stops for the drive there and dogpolicies_near for a quick list without the stay check.
|
|
112
110
|
|
|
113
111
|
Examples:
|
|
114
|
-
|
|
115
112
|
- "Three nights in Monterey with our 70 lb Lab, pet fees under $100" -> place="Monterey", dog_weight_lb=70, nights=3, max_total_fee=100
|
|
116
113
|
- "A weekend in South Lake Tahoe with two small dogs" -> place="South Lake Tahoe", dogs=2, nights=2
|
|
117
114
|
- "Camping near Mammoth Lakes with a dog" -> place="Mono County", stay_types=["campground","cabins"]
|
|
118
115
|
|
|
119
116
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
120
117
|
|
|
121
|
-
| Input
|
|
122
|
-
|
|
123
|
-
| `place`
|
|
124
|
-
| `near`
|
|
125
|
-
| `radius_miles`
|
|
126
|
-
| `dog_weight_lb`
|
|
127
|
-
| `dogs`
|
|
128
|
-
| `nights`
|
|
129
|
-
| `max_total_fee`
|
|
130
|
-
| `stay_types`
|
|
131
|
-
| `include_possible` | boolean (default `true`)
|
|
132
|
-
| `per_section`
|
|
133
|
-
| `response_format`
|
|
118
|
+
| Input | Type | Meaning |
|
|
119
|
+
|---|---|---|
|
|
120
|
+
| `place` | string (min length 2, max length 80) | A city, county or area in California or Nevada, e.g. "Monterey", "South Lake Tahoe", "Washoe County, NV", "Las Vegas", "East Bay" or "Lake Tahoe" |
|
|
121
|
+
| `near` | object | A point instead of a town; give one of place or near |
|
|
122
|
+
| `radius_miles` | number (min 1, max 100, default `15`) | Search radius in miles around the town or point (an area is its own boundary; the radius is ignored) |
|
|
123
|
+
| `dog_weight_lb` | number (min 1, max 250) | The dog's weight in pounds |
|
|
124
|
+
| `dogs` | integer (min 1, max 4, default `1`) | Number of dogs |
|
|
125
|
+
| `nights` | integer (min 1, max 30, default `1`) | Nights of the stay |
|
|
126
|
+
| `max_total_fee` | number (min 0, max 5000) | Most the guest will pay in pet fees for the whole stay, USD |
|
|
127
|
+
| `stay_types` | array of `lodging`, `campground`, `cabins` (default `["lodging","campground","cabins"]`) | Kinds of stay to consider |
|
|
128
|
+
| `include_possible` | boolean (default `true`) | Include stays that need a call to confirm |
|
|
129
|
+
| `per_section` | integer (min 1, max 15, default `5`) | Results per section |
|
|
130
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
134
131
|
|
|
135
132
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `label`, `radius_miles`, `asked`, `stays`, `stay_counts`, `outings` (more may be added; none removed).
|
|
136
133
|
|
|
@@ -143,7 +140,6 @@ Find hotels and motels in California and Nevada that will take a specific dog, w
|
|
|
143
140
|
Each hotel is sorted into "match" (the policy says yes on everything asked), "possible" (nothing rules it out, but something needs a call: a hotel that decides case by case, an unstated weight limit, a limit the hotel lifts with its approval, an "up to" fee) or excluded (left out). Matches come first, cheapest pet fee first. The fee arithmetic is spelled out for every result.
|
|
144
141
|
|
|
145
142
|
Examples:
|
|
146
|
-
|
|
147
143
|
- "Will a Monterey hotel take my 70 lb Lab for under $50?" -> county="Monterey", dog_weight_lb=70, max_total_fee=50
|
|
148
144
|
- "Two dogs, three nights near Palm Springs" -> near={lat:33.83, lon:-116.55}, dogs=2, nights=3
|
|
149
145
|
- "Is the Motel 6 in Fresno dog friendly?" -> query="Motel 6 Fresno"
|
|
@@ -151,23 +147,23 @@ Examples:
|
|
|
151
147
|
|
|
152
148
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
153
149
|
|
|
154
|
-
| Input
|
|
155
|
-
|
|
156
|
-
| `query`
|
|
157
|
-
| `brand`
|
|
158
|
-
| `dog_weight_lb`
|
|
159
|
-
| `dogs`
|
|
160
|
-
| `nights`
|
|
161
|
-
| `max_total_fee`
|
|
162
|
-
| `include_possible` | boolean (default `true`)
|
|
163
|
-
| `state`
|
|
164
|
-
| `county`
|
|
165
|
-
| `region`
|
|
166
|
-
| `area`
|
|
167
|
-
| `near`
|
|
168
|
-
| `limit`
|
|
169
|
-
| `offset`
|
|
170
|
-
| `response_format`
|
|
150
|
+
| Input | Type | Meaning |
|
|
151
|
+
|---|---|---|
|
|
152
|
+
| `query` | string (min length 2, max length 100) | Words in the hotel name, city or brand |
|
|
153
|
+
| `brand` | `best-western`, `extended-stay-america`, `kimpton`, `la-quinta`, `motel-6`, `red-roof` | Only this hotel brand |
|
|
154
|
+
| `dog_weight_lb` | number (min 1, max 250) | The dog's weight in pounds |
|
|
155
|
+
| `dogs` | integer (min 1, max 4, default `1`) | Number of dogs |
|
|
156
|
+
| `nights` | integer (min 1, max 30, default `1`) | Nights of the stay |
|
|
157
|
+
| `max_total_fee` | number (min 0, max 5000) | Most the guest will pay in pet fees for the whole stay, USD |
|
|
158
|
+
| `include_possible` | boolean (default `true`) | Include hotels that need a call to confirm |
|
|
159
|
+
| `state` | `CA`, `NV` | "CA" or "NV". Also tells apart counties with the same name, such as Humboldt. |
|
|
160
|
+
| `county` | string (min length 2, max length 40) | County name without "County", in California or Nevada, e.g. "Monterey" or "Washoe" |
|
|
161
|
+
| `region` | `north-coast`, `shasta-cascade`, `gold-country`, `high-sierra`, `bay-area`, `central-coast`, `central-valley`, `inland-empire-deserts`, `los-angeles`, `orange-county`, `san-diego`, `reno-tahoe-nevada`, `las-vegas-southern-nevada`, `northern-central-nevada` | Region id, e.g. central-coast, san-diego or reno-tahoe-nevada |
|
|
162
|
+
| `area` | string (min length 2, max length 60) | Area id, the name a traveler gives the trip: san-francisco, east-bay, peninsula, south-bay, north-bay, lake-tahoe, big-sur, mendocino-coast, yosemite, death-valley |
|
|
163
|
+
| `near` | object | Limit to places near a point; results are sorted by distance |
|
|
164
|
+
| `limit` | integer (min 1, max 50, default `10`) | Maximum results to return |
|
|
165
|
+
| `offset` | integer (min 0, max 9007199254740991, default `0`) | Results to skip, for pagination |
|
|
166
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
171
167
|
|
|
172
168
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `total`, `count`, `offset`, `has_more`, `hotels`, `counts` (more may be added; none removed).
|
|
173
169
|
|
|
@@ -181,10 +177,10 @@ Brands covered: Best Western (best-western), Extended Stay America (extended-sta
|
|
|
181
177
|
|
|
182
178
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
183
179
|
|
|
184
|
-
| Input
|
|
185
|
-
|
|
186
|
-
| `brand` (required) | string (min length 2, max length 60)
|
|
187
|
-
| `response_format`
|
|
180
|
+
| Input | Type | Meaning |
|
|
181
|
+
|---|---|---|
|
|
182
|
+
| `brand` (required) | string (min length 2, max length 60) | Brand id or name |
|
|
183
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
188
184
|
|
|
189
185
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `id`, `name`, `answer`, `facts`, `not_stated`, `verified_at`, `url`, `source_urls` (more may be added; none removed).
|
|
190
186
|
|
|
@@ -198,12 +194,12 @@ Without a slug, lists every question with its slug and result count. With a slug
|
|
|
198
194
|
|
|
199
195
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
200
196
|
|
|
201
|
-
| Input
|
|
202
|
-
|
|
203
|
-
| `slug`
|
|
204
|
-
| `limit`
|
|
205
|
-
| `offset`
|
|
206
|
-
| `response_format` | `markdown`, `json` (default `"markdown"`)
|
|
197
|
+
| Input | Type | Meaning |
|
|
198
|
+
|---|---|---|
|
|
199
|
+
| `slug` | string (min length 3, max length 120) | Question slug from the list, e.g. "off-leash-dog-beaches-california" |
|
|
200
|
+
| `limit` | integer (min 1, max 50, default `10`) | Maximum results to return |
|
|
201
|
+
| `offset` | integer (min 0, max 9007199254740991, default `0`) | Results to skip, for pagination |
|
|
202
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
207
203
|
|
|
208
204
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `total`, `questions`, `places` (more may be added; none removed).
|
|
209
205
|
|
|
@@ -218,7 +214,6 @@ Each stop has its mile on the route and its distance off the road. Each route co
|
|
|
218
214
|
Routes covered: I-5 (i-5, 796 miles), US-101 (us-101, 809 miles), Highway 1 (highway-1, 736 miles), I-15 (i-15, 294 miles), I-80 (i-80, 204 miles), US-50 (us-50, 109 miles), I-15 (i-15-nevada, 124 miles), I-80 (i-80-nevada, 410 miles), US-50 (us-50-nevada, 409 miles), US-95 (us-95-nevada, 664 miles), US-93 (us-93-nevada, 526 miles).
|
|
219
215
|
|
|
220
216
|
Examples:
|
|
221
|
-
|
|
222
217
|
- "Driving north on I-5 from Los Angeles with a 70 lb dog, where can we stop?" -> near={lat:34.05, lon:-118.24}, direction="north", dog_weight_lb=70
|
|
223
218
|
- "Pet areas on the Grapevine" -> from_mile=170, to_mile=222, kinds=["rest_area","park"]
|
|
224
219
|
- "Heading south on 101 from San Francisco to Santa Barbara, where can the dog run?" -> route="us-101", near={lat:37.77, lon:-122.42}, to_mile=100, direction="south"
|
|
@@ -227,22 +222,22 @@ Examples:
|
|
|
227
222
|
|
|
228
223
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
229
224
|
|
|
230
|
-
| Input
|
|
231
|
-
|
|
232
|
-
| `route`
|
|
233
|
-
| `near`
|
|
234
|
-
| `from_mile`
|
|
235
|
-
| `to_mile`
|
|
236
|
-
| `direction`
|
|
237
|
-
| `kinds`
|
|
238
|
-
| `dog_friendly_only` | boolean (default `true`)
|
|
239
|
-
| `dog_weight_lb`
|
|
240
|
-
| `dogs`
|
|
241
|
-
| `nights`
|
|
242
|
-
| `max_total_fee`
|
|
243
|
-
| `limit`
|
|
244
|
-
| `offset`
|
|
245
|
-
| `response_format`
|
|
225
|
+
| Input | Type | Meaning |
|
|
226
|
+
|---|---|---|
|
|
227
|
+
| `route` | `i-5`, `us-101`, `highway-1`, `i-15`, `i-80`, `us-50`, `i-15-nevada`, `i-80-nevada`, `us-50-nevada`, `us-95-nevada`, `us-93-nevada` (default `"i-5"`) | Route id |
|
|
228
|
+
| `near` | object | Start from the route mile nearest this point |
|
|
229
|
+
| `from_mile` | number (min 0, max 1000) | Start at this route mile |
|
|
230
|
+
| `to_mile` | number (min 0, max 1000) | Stop at this route mile |
|
|
231
|
+
| `direction` | `north`, `south`, `east`, `west` (default `"north"`) | Direction of travel. Route miles increase going north, or east on I-80 and US-50; north and east both mean increasing miles |
|
|
232
|
+
| `kinds` | array of `rest_area`, `stop`, `lodging`, `campground`, `cabins`, `park`, `beach`, `trail`, `restaurant` | Kinds of stops to include; all by default |
|
|
233
|
+
| `dog_friendly_only` | boolean (default `true`) | Leave out stops where dogs are not allowed |
|
|
234
|
+
| `dog_weight_lb` | number (min 1, max 250) | The dog's weight in pounds |
|
|
235
|
+
| `dogs` | integer (min 1, max 4, default `1`) | Number of dogs |
|
|
236
|
+
| `nights` | integer (min 1, max 30, default `1`) | Nights of the stay |
|
|
237
|
+
| `max_total_fee` | number (min 0, max 5000) | Most the guest will pay in pet fees for the whole stay, USD |
|
|
238
|
+
| `limit` | integer (min 1, max 50, default `10`) | Maximum results to return |
|
|
239
|
+
| `offset` | integer (min 0, max 9007199254740991, default `0`) | Results to skip, for pagination |
|
|
240
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
246
241
|
|
|
247
242
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `total`, `count`, `offset`, `has_more`, `stops`, `route`, `guide` (more may be added; none removed).
|
|
248
243
|
|
|
@@ -254,9 +249,9 @@ One rule (a fee, a leash rule, a weight limit) by its stable id, with its value,
|
|
|
254
249
|
|
|
255
250
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
256
251
|
|
|
257
|
-
| Input
|
|
258
|
-
|
|
259
|
-
| `id` (required)
|
|
252
|
+
| Input | Type | Meaning |
|
|
253
|
+
|---|---|---|
|
|
254
|
+
| `id` (required) | string (min length 6, max length 80) | Rule id, e.g. "rul_t6cqwy0x4ce2dmpq_fee" |
|
|
260
255
|
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
261
256
|
|
|
262
257
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `rule`, `place` (more may be added; none removed).
|
|
@@ -269,13 +264,13 @@ Everything that changed in the whole data set since a date: verification events
|
|
|
269
264
|
|
|
270
265
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
271
266
|
|
|
272
|
-
| Input
|
|
273
|
-
|
|
274
|
-
| `since` (required) | string
|
|
275
|
-
| `outcome`
|
|
276
|
-
| `limit`
|
|
277
|
-
| `offset`
|
|
278
|
-
| `response_format`
|
|
267
|
+
| Input | Type | Meaning |
|
|
268
|
+
|---|---|---|
|
|
269
|
+
| `since` (required) | string | Date, YYYY-MM-DD |
|
|
270
|
+
| `outcome` | `confirmed`, `changed`, `source_gone`, `blocked`, `disputed` | Only events with this outcome |
|
|
271
|
+
| `limit` | integer (min 1, max 50, default `10`) | Maximum results to return |
|
|
272
|
+
| `offset` | integer (min 0, max 9007199254740991, default `0`) | Results to skip, for pagination |
|
|
273
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
279
274
|
|
|
280
275
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `total`, `count`, `has_more`, `events`, `rule_changes` (more may be added; none removed).
|
|
281
276
|
|
|
@@ -289,16 +284,16 @@ Example: "What changed near Monterey since September?" -> place="Monterey", sinc
|
|
|
289
284
|
|
|
290
285
|
Annotations: read-only true, destructive false, idempotent true, open-world false.
|
|
291
286
|
|
|
292
|
-
| Input
|
|
293
|
-
|
|
294
|
-
| `place`
|
|
295
|
-
| `near`
|
|
296
|
-
| `radius_miles`
|
|
297
|
-
| `since` (required) | string
|
|
298
|
-
| `outcome`
|
|
299
|
-
| `limit`
|
|
300
|
-
| `offset`
|
|
301
|
-
| `response_format`
|
|
287
|
+
| Input | Type | Meaning |
|
|
288
|
+
|---|---|---|
|
|
289
|
+
| `place` | string (min length 2, max length 80) | A city, county or area in California or Nevada, e.g. "Monterey", "South Lake Tahoe", "Washoe County, NV", "Las Vegas", "East Bay" or "Lake Tahoe" |
|
|
290
|
+
| `near` | object | A point instead of a town; give one of place or near |
|
|
291
|
+
| `radius_miles` | number (min 1, max 100, default `15`) | Search radius in miles around the town or point (an area is its own boundary; the radius is ignored) |
|
|
292
|
+
| `since` (required) | string | Date, YYYY-MM-DD |
|
|
293
|
+
| `outcome` | `confirmed`, `changed`, `source_gone`, `blocked`, `disputed` | Only events with this outcome |
|
|
294
|
+
| `limit` | integer (min 1, max 50, default `10`) | Maximum results to return |
|
|
295
|
+
| `offset` | integer (min 0, max 9007199254740991, default `0`) | Results to skip, for pagination |
|
|
296
|
+
| `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
|
|
302
297
|
|
|
303
298
|
Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `label`, `radius_miles`, `total`, `count`, `has_more`, `events` (more may be added; none removed).
|
|
304
299
|
|
|
@@ -310,36 +305,36 @@ File a correction when a user says a rule on a record is wrong or has changed (a
|
|
|
310
305
|
|
|
311
306
|
Annotations: read-only false, destructive false, idempotent false, open-world true.
|
|
312
307
|
|
|
313
|
-
| Input
|
|
314
|
-
|
|
315
|
-
| `place_id` (required) | string (min length 2, max length 120)
|
|
316
|
-
| `message` (required)
|
|
317
|
-
| `source_url`
|
|
318
|
-
| `contact`
|
|
308
|
+
| Input | Type | Meaning |
|
|
309
|
+
|---|---|---|
|
|
310
|
+
| `place_id` (required) | string (min length 2, max length 120) | Place id from a search result |
|
|
311
|
+
| `message` (required) | string (min length 5, max length 2000) | What is wrong, in the user's words |
|
|
312
|
+
| `source_url` | string (max length 500) | The official page that shows the current rule, if the user has it |
|
|
313
|
+
| `contact` | string (max length 200) | How to reach the reporter, only if they offer it |
|
|
319
314
|
|
|
320
315
|
Output fields: `report_id`, `place_id`, `status`, `url` (more may be added; none removed).
|
|
321
316
|
|
|
322
317
|
# Resources
|
|
323
318
|
|
|
324
|
-
| URI
|
|
325
|
-
|
|
326
|
-
| `dogpolicies://about`
|
|
327
|
-
| `dogpolicies://status`
|
|
328
|
-
| `dogpolicies://answers`
|
|
329
|
-
| `dogpolicies://place/{id}`
|
|
330
|
-
| `dogpolicies://brand/{id}`
|
|
331
|
-
| `dogpolicies://answer/{slug}` | The places that answer one ready-made question
|
|
332
|
-
| `dogpolicies://route/{id}`
|
|
333
|
-
| `dogpolicies://area/{id}`
|
|
319
|
+
| URI | What | Type |
|
|
320
|
+
|---|---|---|
|
|
321
|
+
| `dogpolicies://about` | What the data is, how to cite it, the license and the tool list | text/markdown |
|
|
322
|
+
| `dogpolicies://status` | Data version and origin, counts, and this process's call statistics (nothing leaves the machine) | application/json |
|
|
323
|
+
| `dogpolicies://answers` | Every ready-made question with its slug and result count | text/markdown |
|
|
324
|
+
| `dogpolicies://place/{id}` | One place's dog rules with sources, quotes and rule ids, as markdown | text/markdown |
|
|
325
|
+
| `dogpolicies://brand/{id}` | A chain's published pet policy, exceptions and property counts | text/markdown |
|
|
326
|
+
| `dogpolicies://answer/{slug}` | The places that answer one ready-made question | text/markdown |
|
|
327
|
+
| `dogpolicies://route/{id}` | Dog-friendly stops along one highway in driving order | text/markdown |
|
|
328
|
+
| `dogpolicies://area/{id}` | Every dog-related place in one area (East Bay, Lake Tahoe, Big Sur), grouped by kind | text/markdown |
|
|
334
329
|
|
|
335
330
|
Templates support completion (`completion/complete`) for their variable.
|
|
336
331
|
|
|
337
332
|
# Prompts
|
|
338
333
|
|
|
339
|
-
| Name
|
|
340
|
-
|
|
341
|
-
| `plan_dog_trip`
|
|
342
|
-
| `check_hotel_for_dog`
|
|
343
|
-
| `road_trip_with_dog`
|
|
344
|
-
| `what_can_my_dog_do_here` | Beaches, parks, trails, patios and stays near a town, with the rule for each
|
|
345
|
-
| `cite_a_rule`
|
|
334
|
+
| Name | What | Arguments |
|
|
335
|
+
|---|---|---|
|
|
336
|
+
| `plan_dog_trip` | A stay in a California or Nevada town: where to stay with this dog, what to do, where to eat, with sources | `destination`, `dog`, `nights`, `budget` |
|
|
337
|
+
| `check_hotel_for_dog` | Check one hotel or a town's hotels against a specific dog: weight, count, nights, fee | `hotel_or_town`, `dog_weight_lb`, `dogs`, `nights` |
|
|
338
|
+
| `road_trip_with_dog` | Dog-friendly stops along a highway in driving order: rest areas, parks, hotels within budget | `route`, `from`, `direction`, `dog_weight_lb` |
|
|
339
|
+
| `what_can_my_dog_do_here` | Beaches, parks, trails, patios and stays near a town, with the rule for each | `place` |
|
|
340
|
+
| `cite_a_rule` | The official rule for one place with the quoted source text, ready to cite | `place_id` |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dogpolicies-mcp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.5",
|
|
4
4
|
"description": "MCP server for verified dog rules at California and Nevada parks, beaches, trails, hotels, campgrounds and restaurant patios: leash rules, pet fees, weight limits, trip planning, every fact with its official source and the date it was checked.",
|
|
5
5
|
"mcpName": "io.github.xultrax-web/dogpolicies-mcp",
|
|
6
6
|
"type": "module",
|
|
@@ -49,7 +49,9 @@
|
|
|
49
49
|
"docs": "node scripts/docs.mjs",
|
|
50
50
|
"contracts": "node scripts/contracts.mjs",
|
|
51
51
|
"eval": "node --test test/eval.test.mjs",
|
|
52
|
-
"format": "prettier --write ."
|
|
52
|
+
"format": "prettier --write .",
|
|
53
|
+
"mcpb": "node scripts/mcpb.mjs",
|
|
54
|
+
"icon": "node scripts/icon.mjs"
|
|
53
55
|
},
|
|
54
56
|
"dependencies": {
|
|
55
57
|
"@modelcontextprotocol/server": "^2.4.0",
|
package/server.json
CHANGED
|
@@ -8,13 +8,13 @@
|
|
|
8
8
|
"url": "https://github.com/xultrax-web/dogpolicies-mcp",
|
|
9
9
|
"source": "github"
|
|
10
10
|
},
|
|
11
|
-
"version": "0.2.
|
|
11
|
+
"version": "0.2.5",
|
|
12
12
|
"packages": [
|
|
13
13
|
{
|
|
14
14
|
"registryType": "npm",
|
|
15
15
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
16
16
|
"identifier": "dogpolicies-mcp",
|
|
17
|
-
"version": "0.2.
|
|
17
|
+
"version": "0.2.5",
|
|
18
18
|
"runtimeHint": "npx",
|
|
19
19
|
"transport": {
|
|
20
20
|
"type": "stdio"
|
|
@@ -0,0 +1,431 @@
|
|
|
1
|
+
// `dogpolicies-mcp install`: puts the server into an AI client's configuration
|
|
2
|
+
// the way a careful person would. Finds the client's file on Windows, macOS
|
|
3
|
+
// and Linux; creates the file or the `mcpServers` key when missing; merges one
|
|
4
|
+
// entry without touching anything else; writes a timestamped backup first;
|
|
5
|
+
// refuses a file it cannot parse instead of overwriting it; does the same
|
|
6
|
+
// thing twice without changing anything; needs no admin rights; and prints
|
|
7
|
+
// the exact restart step for that client.
|
|
8
|
+
//
|
|
9
|
+
// Everything that decides is pure (planInstall) and testable with a fake
|
|
10
|
+
// platform, home and environment; only applyPlan touches the disk.
|
|
11
|
+
|
|
12
|
+
import {
|
|
13
|
+
existsSync,
|
|
14
|
+
mkdirSync,
|
|
15
|
+
readFileSync,
|
|
16
|
+
writeFileSync,
|
|
17
|
+
copyFileSync,
|
|
18
|
+
} from "node:fs";
|
|
19
|
+
import { dirname, join } from "node:path";
|
|
20
|
+
import { homedir } from "node:os";
|
|
21
|
+
import { spawnSync } from "node:child_process";
|
|
22
|
+
import { DEFAULT_BASE_URL, PACKAGE_NAME, REMOTE_MCP_PATH } from "../config.mjs";
|
|
23
|
+
|
|
24
|
+
export const SERVER_KEY = "dogpolicies";
|
|
25
|
+
export const HOSTED_URL = `${DEFAULT_BASE_URL}${REMOTE_MCP_PATH}`;
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* On Windows, Claude Desktop, Cursor and the others spawn the command without
|
|
29
|
+
* a shell, and `npx` is `npx.cmd`, a batch file, so "spawn npx ENOENT" is the
|
|
30
|
+
* most reported MCP error on Windows. `cmd /c npx ...` is the form that works
|
|
31
|
+
* (Node 18.20+ also refuses to spawn a .cmd directly without a shell).
|
|
32
|
+
*/
|
|
33
|
+
export function stdioCommand(platform) {
|
|
34
|
+
const npx = ["npx", "-y", PACKAGE_NAME];
|
|
35
|
+
return platform === "win32"
|
|
36
|
+
? { command: "cmd", args: ["/c", ...npx] }
|
|
37
|
+
: { command: "npx", args: ["-y", PACKAGE_NAME] };
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
const home = (env, fallback) =>
|
|
41
|
+
env.DOGPOLICIES_HOME_FOR_TESTS ??
|
|
42
|
+
env.HOME ??
|
|
43
|
+
env.USERPROFILE ??
|
|
44
|
+
fallback ??
|
|
45
|
+
homedir();
|
|
46
|
+
|
|
47
|
+
/** Every client this command knows, with where its file lives and what it expects. */
|
|
48
|
+
export const CLIENTS = {
|
|
49
|
+
"claude-desktop": {
|
|
50
|
+
label: "Claude Desktop",
|
|
51
|
+
key: "mcpServers",
|
|
52
|
+
configPath: ({ platform, env, homeDir }) => {
|
|
53
|
+
if (platform === "win32")
|
|
54
|
+
return join(
|
|
55
|
+
env.APPDATA ?? join(homeDir, "AppData", "Roaming"),
|
|
56
|
+
"Claude",
|
|
57
|
+
"claude_desktop_config.json",
|
|
58
|
+
);
|
|
59
|
+
if (platform === "darwin")
|
|
60
|
+
return join(
|
|
61
|
+
homeDir,
|
|
62
|
+
"Library",
|
|
63
|
+
"Application Support",
|
|
64
|
+
"Claude",
|
|
65
|
+
"claude_desktop_config.json",
|
|
66
|
+
);
|
|
67
|
+
return join(
|
|
68
|
+
env.XDG_CONFIG_HOME ?? join(homeDir, ".config"),
|
|
69
|
+
"Claude",
|
|
70
|
+
"claude_desktop_config.json",
|
|
71
|
+
);
|
|
72
|
+
},
|
|
73
|
+
stdio: (platform) => stdioCommand(platform),
|
|
74
|
+
// Claude Desktop adds remote servers through its own UI, not the file.
|
|
75
|
+
hosted: null,
|
|
76
|
+
hostedSteps: [
|
|
77
|
+
"Claude Desktop and claude.ai connect to the hosted server through the app, not a file:",
|
|
78
|
+
" Settings > Connectors > Add custom connector",
|
|
79
|
+
` Name: DogPolicies URL: ${HOSTED_URL}`,
|
|
80
|
+
" Then turn it on in the chat's tools menu. Nothing to install, no Node.js needed.",
|
|
81
|
+
],
|
|
82
|
+
restart: (platform) =>
|
|
83
|
+
platform === "win32"
|
|
84
|
+
? "Fully quit Claude Desktop: right-click the Claude icon in the system tray (bottom right, near the clock) and choose Quit, then open Claude again. Closing the window is not enough."
|
|
85
|
+
: platform === "darwin"
|
|
86
|
+
? "Fully quit Claude Desktop: Claude menu > Quit Claude (Cmd+Q), then open it again. Closing the window is not enough."
|
|
87
|
+
: "Fully quit Claude Desktop and open it again.",
|
|
88
|
+
logs: (platform) =>
|
|
89
|
+
platform === "win32"
|
|
90
|
+
? "%APPDATA%\\Claude\\logs\\mcp.log and mcp-server-dogpolicies.log"
|
|
91
|
+
: platform === "darwin"
|
|
92
|
+
? "~/Library/Logs/Claude/mcp.log and mcp-server-dogpolicies.log"
|
|
93
|
+
: "~/.config/Claude/logs/",
|
|
94
|
+
},
|
|
95
|
+
cursor: {
|
|
96
|
+
label: "Cursor",
|
|
97
|
+
key: "mcpServers",
|
|
98
|
+
configPath: ({ homeDir }) => join(homeDir, ".cursor", "mcp.json"),
|
|
99
|
+
stdio: (platform) => stdioCommand(platform),
|
|
100
|
+
hosted: () => ({ url: HOSTED_URL }),
|
|
101
|
+
restart: () =>
|
|
102
|
+
"Open Cursor Settings > MCP (or Customize in the sidebar); the server appears there. Toggle it on if it is off, or restart Cursor.",
|
|
103
|
+
logs: () => "Cursor: Output panel (Ctrl+Shift+U / Cmd+Shift+U) > MCP Logs",
|
|
104
|
+
},
|
|
105
|
+
vscode: {
|
|
106
|
+
label: "VS Code (Copilot)",
|
|
107
|
+
key: "mcpServers",
|
|
108
|
+
// The portable Copilot file is what VS Code's guided flow calls "Global >
|
|
109
|
+
// Copilot Global"; the Copilot CLI reads it too. The profile mcp.json
|
|
110
|
+
// (`servers` key) is the older form; `code --add-mcp` writes that one.
|
|
111
|
+
configPath: ({ env, homeDir }) =>
|
|
112
|
+
join(env.COPILOT_HOME ?? join(homeDir, ".copilot"), "mcp-config.json"),
|
|
113
|
+
stdio: (platform) => stdioCommand(platform),
|
|
114
|
+
hosted: () => ({ type: "http", url: HOSTED_URL }),
|
|
115
|
+
cli: (platform, hosted) =>
|
|
116
|
+
hosted
|
|
117
|
+
? `code --add-mcp "{\\"name\\":\\"dogpolicies\\",\\"type\\":\\"http\\",\\"url\\":\\"${HOSTED_URL}\\"}"`
|
|
118
|
+
: `code --add-mcp "{\\"name\\":\\"dogpolicies\\",\\"type\\":\\"stdio\\",\\"command\\":\\"${stdioCommand(platform).command}\\",\\"args\\":${JSON.stringify(stdioCommand(platform).args).replaceAll('"', '\\"')}}"`,
|
|
119
|
+
restart: () =>
|
|
120
|
+
"In VS Code run MCP: List Servers from the command palette and start dogpolicies, or reload the window (Developer: Reload Window).",
|
|
121
|
+
logs: () =>
|
|
122
|
+
"VS Code: command palette > MCP: List Servers > dogpolicies > Show Output",
|
|
123
|
+
},
|
|
124
|
+
windsurf: {
|
|
125
|
+
label: "Windsurf",
|
|
126
|
+
key: "mcpServers",
|
|
127
|
+
configPath: ({ homeDir }) =>
|
|
128
|
+
join(homeDir, ".codeium", "windsurf", "mcp_config.json"),
|
|
129
|
+
stdio: (platform) => stdioCommand(platform),
|
|
130
|
+
hosted: () => ({ serverUrl: HOSTED_URL }),
|
|
131
|
+
restart: () =>
|
|
132
|
+
"In Windsurf open the Cascade MCP panel and press Refresh, or restart Windsurf.",
|
|
133
|
+
logs: () => "Windsurf: Output panel > Windsurf MCP",
|
|
134
|
+
},
|
|
135
|
+
"claude-code": {
|
|
136
|
+
label: "Claude Code",
|
|
137
|
+
// Claude Code has a CLI; the command is the right way in, not its file.
|
|
138
|
+
command: (platform, hosted) =>
|
|
139
|
+
hosted
|
|
140
|
+
? [
|
|
141
|
+
"claude",
|
|
142
|
+
"mcp",
|
|
143
|
+
"add",
|
|
144
|
+
"--scope",
|
|
145
|
+
"user",
|
|
146
|
+
"--transport",
|
|
147
|
+
"http",
|
|
148
|
+
SERVER_KEY,
|
|
149
|
+
HOSTED_URL,
|
|
150
|
+
]
|
|
151
|
+
: [
|
|
152
|
+
"claude",
|
|
153
|
+
"mcp",
|
|
154
|
+
"add",
|
|
155
|
+
"--scope",
|
|
156
|
+
"user",
|
|
157
|
+
SERVER_KEY,
|
|
158
|
+
"--",
|
|
159
|
+
...[stdioCommand(platform).command, ...stdioCommand(platform).args],
|
|
160
|
+
],
|
|
161
|
+
removeCommand: () => [
|
|
162
|
+
"claude",
|
|
163
|
+
"mcp",
|
|
164
|
+
"remove",
|
|
165
|
+
"--scope",
|
|
166
|
+
"user",
|
|
167
|
+
SERVER_KEY,
|
|
168
|
+
],
|
|
169
|
+
restart: () =>
|
|
170
|
+
"Start a new Claude Code session; `claude mcp list` shows dogpolicies.",
|
|
171
|
+
logs: () => "Claude Code: `claude mcp list`, or run with --mcp-debug",
|
|
172
|
+
},
|
|
173
|
+
};
|
|
174
|
+
|
|
175
|
+
export const CLIENT_IDS = Object.keys(CLIENTS);
|
|
176
|
+
|
|
177
|
+
/** Pretty JSON the way the clients write it. */
|
|
178
|
+
const pretty = (obj) => JSON.stringify(obj, null, 2) + "\n";
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* Decides what to do for one client without touching the disk.
|
|
182
|
+
*
|
|
183
|
+
* @param {object} o
|
|
184
|
+
* @param {string} o.client one of CLIENT_IDS
|
|
185
|
+
* @param {boolean} [o.hosted] write the remote URL form where the client supports it
|
|
186
|
+
* @param {boolean} [o.uninstall]
|
|
187
|
+
* @param {string} [o.platform] process.platform by default
|
|
188
|
+
* @param {object} [o.env] process.env by default
|
|
189
|
+
* @param {string} [o.homeDir]
|
|
190
|
+
* @param {() => Date} [o.now]
|
|
191
|
+
* @returns {object} a plan: { kind: "file" | "command" | "steps" | "noop" | "error", ... }
|
|
192
|
+
*/
|
|
193
|
+
export function planInstall({
|
|
194
|
+
client,
|
|
195
|
+
hosted = false,
|
|
196
|
+
uninstall = false,
|
|
197
|
+
platform = process.platform,
|
|
198
|
+
env = process.env,
|
|
199
|
+
homeDir,
|
|
200
|
+
now = () => new Date(),
|
|
201
|
+
}) {
|
|
202
|
+
const spec = CLIENTS[client];
|
|
203
|
+
if (!spec)
|
|
204
|
+
return {
|
|
205
|
+
kind: "error",
|
|
206
|
+
client,
|
|
207
|
+
message: `Unknown client "${client}". Known: ${CLIENT_IDS.join(", ")}.`,
|
|
208
|
+
};
|
|
209
|
+
const h = homeDir ?? home(env);
|
|
210
|
+
const base = {
|
|
211
|
+
client,
|
|
212
|
+
label: spec.label,
|
|
213
|
+
hosted,
|
|
214
|
+
uninstall,
|
|
215
|
+
restart: spec.restart(platform),
|
|
216
|
+
logs: spec.logs(platform),
|
|
217
|
+
};
|
|
218
|
+
|
|
219
|
+
if (spec.command) {
|
|
220
|
+
const argv = uninstall
|
|
221
|
+
? spec.removeCommand()
|
|
222
|
+
: spec.command(platform, hosted);
|
|
223
|
+
return {
|
|
224
|
+
...base,
|
|
225
|
+
kind: "command",
|
|
226
|
+
argv,
|
|
227
|
+
display: argv
|
|
228
|
+
.map((a) => (/\s/.test(a) ? JSON.stringify(a) : a))
|
|
229
|
+
.join(" "),
|
|
230
|
+
};
|
|
231
|
+
}
|
|
232
|
+
if (hosted && !spec.hosted)
|
|
233
|
+
return { ...base, kind: "steps", steps: spec.hostedSteps };
|
|
234
|
+
|
|
235
|
+
const path = spec.configPath({ platform, env, homeDir: h });
|
|
236
|
+
let current = null;
|
|
237
|
+
let existed = false;
|
|
238
|
+
if (existsSync(path)) {
|
|
239
|
+
existed = true;
|
|
240
|
+
const text = readFileSync(path, "utf8");
|
|
241
|
+
if (text.trim() === "") current = {};
|
|
242
|
+
else {
|
|
243
|
+
try {
|
|
244
|
+
current = JSON.parse(text);
|
|
245
|
+
} catch (error) {
|
|
246
|
+
return {
|
|
247
|
+
...base,
|
|
248
|
+
kind: "error",
|
|
249
|
+
path,
|
|
250
|
+
message: `${spec.label}'s config at ${path} is not valid JSON (${error.message}). Nothing was changed. Open the file, fix the syntax (a stray comma is the usual cause) or move it aside, then run this again.`,
|
|
251
|
+
};
|
|
252
|
+
}
|
|
253
|
+
if (!current || typeof current !== "object" || Array.isArray(current))
|
|
254
|
+
return {
|
|
255
|
+
...base,
|
|
256
|
+
kind: "error",
|
|
257
|
+
path,
|
|
258
|
+
message: `${path} does not contain a JSON object. Nothing was changed.`,
|
|
259
|
+
};
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
const next = structuredClone(current ?? {});
|
|
263
|
+
const key = spec.key;
|
|
264
|
+
if (
|
|
265
|
+
next[key] !== undefined &&
|
|
266
|
+
(typeof next[key] !== "object" || Array.isArray(next[key]))
|
|
267
|
+
)
|
|
268
|
+
return {
|
|
269
|
+
...base,
|
|
270
|
+
kind: "error",
|
|
271
|
+
path,
|
|
272
|
+
message: `${path} has a "${key}" that is not an object. Nothing was changed.`,
|
|
273
|
+
};
|
|
274
|
+
const entry = hosted ? spec.hosted() : spec.stdio(platform);
|
|
275
|
+
if (uninstall) {
|
|
276
|
+
if (!next[key]?.[SERVER_KEY])
|
|
277
|
+
return {
|
|
278
|
+
...base,
|
|
279
|
+
kind: "noop",
|
|
280
|
+
path,
|
|
281
|
+
message: `${spec.label} has no "${SERVER_KEY}" entry; nothing to remove.`,
|
|
282
|
+
};
|
|
283
|
+
delete next[key][SERVER_KEY];
|
|
284
|
+
} else {
|
|
285
|
+
next[key] ??= {};
|
|
286
|
+
if (JSON.stringify(next[key][SERVER_KEY]) === JSON.stringify(entry))
|
|
287
|
+
return {
|
|
288
|
+
...base,
|
|
289
|
+
kind: "noop",
|
|
290
|
+
path,
|
|
291
|
+
entry,
|
|
292
|
+
message: `${spec.label} already has this exact "${SERVER_KEY}" entry in ${path}; nothing changed.`,
|
|
293
|
+
};
|
|
294
|
+
next[key][SERVER_KEY] = entry;
|
|
295
|
+
}
|
|
296
|
+
const stamp = now().toISOString().replace(/[:.]/g, "-").slice(0, 19);
|
|
297
|
+
return {
|
|
298
|
+
...base,
|
|
299
|
+
kind: "file",
|
|
300
|
+
path,
|
|
301
|
+
existed,
|
|
302
|
+
entry: uninstall ? null : entry,
|
|
303
|
+
before: current,
|
|
304
|
+
after: next,
|
|
305
|
+
text: pretty(next),
|
|
306
|
+
backupPath: existed ? `${path}.${stamp}.bak` : null,
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
/** Writes a "file" plan: backup first, then the merged file. Creates folders. */
|
|
311
|
+
export function applyPlan(plan) {
|
|
312
|
+
if (plan.kind !== "file") return plan;
|
|
313
|
+
mkdirSync(dirname(plan.path), { recursive: true });
|
|
314
|
+
if (plan.backupPath) copyFileSync(plan.path, plan.backupPath);
|
|
315
|
+
writeFileSync(plan.path, plan.text);
|
|
316
|
+
return { ...plan, written: true };
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
/** Which clients look present on this machine (their folder exists). */
|
|
320
|
+
export function detectClients({
|
|
321
|
+
platform = process.platform,
|
|
322
|
+
env = process.env,
|
|
323
|
+
homeDir,
|
|
324
|
+
} = {}) {
|
|
325
|
+
const h = homeDir ?? home(env);
|
|
326
|
+
const found = [];
|
|
327
|
+
for (const [id, spec] of Object.entries(CLIENTS)) {
|
|
328
|
+
if (spec.command) continue;
|
|
329
|
+
const dir = dirname(spec.configPath({ platform, env, homeDir: h }));
|
|
330
|
+
if (existsSync(dir)) found.push(id);
|
|
331
|
+
}
|
|
332
|
+
return found;
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
/** The whole command: plan, apply (unless dry run), print. Returns the exit code. */
|
|
336
|
+
export function runInstall(
|
|
337
|
+
{ clients, hosted = false, dryRun = false, uninstall = false, all = false },
|
|
338
|
+
{
|
|
339
|
+
platform = process.platform,
|
|
340
|
+
env = process.env,
|
|
341
|
+
homeDir,
|
|
342
|
+
print = (s) => process.stdout.write(s + "\n"),
|
|
343
|
+
run = spawnSync,
|
|
344
|
+
} = {},
|
|
345
|
+
) {
|
|
346
|
+
let targets = clients;
|
|
347
|
+
if (!targets?.length) {
|
|
348
|
+
const detected = detectClients({ platform, env, homeDir });
|
|
349
|
+
if (all) targets = detected.length ? detected : ["claude-desktop"];
|
|
350
|
+
else {
|
|
351
|
+
targets = [
|
|
352
|
+
detected.includes("claude-desktop") || !detected.length
|
|
353
|
+
? "claude-desktop"
|
|
354
|
+
: detected[0],
|
|
355
|
+
];
|
|
356
|
+
print(
|
|
357
|
+
`No --client given; ${detected.length ? `found ${detected.join(", ")}; ` : ""}installing for ${CLIENTS[targets[0]].label}. Others: --client ${CLIENT_IDS.filter((c) => c !== targets[0]).join(" | ")}, or --all.`,
|
|
358
|
+
);
|
|
359
|
+
}
|
|
360
|
+
}
|
|
361
|
+
let failed = 0;
|
|
362
|
+
for (const client of targets) {
|
|
363
|
+
const plan = planInstall({
|
|
364
|
+
client,
|
|
365
|
+
hosted,
|
|
366
|
+
uninstall,
|
|
367
|
+
platform,
|
|
368
|
+
env,
|
|
369
|
+
homeDir,
|
|
370
|
+
});
|
|
371
|
+
print("");
|
|
372
|
+
print(`== ${plan.label ?? client} ==`);
|
|
373
|
+
if (plan.kind === "error") {
|
|
374
|
+
failed++;
|
|
375
|
+
print(`Refused: ${plan.message}`);
|
|
376
|
+
continue;
|
|
377
|
+
}
|
|
378
|
+
if (plan.kind === "steps") {
|
|
379
|
+
for (const s of plan.steps) print(s);
|
|
380
|
+
continue;
|
|
381
|
+
}
|
|
382
|
+
if (plan.kind === "noop") {
|
|
383
|
+
print(plan.message);
|
|
384
|
+
print(`Restart step, in case it is not showing yet: ${plan.restart}`);
|
|
385
|
+
continue;
|
|
386
|
+
}
|
|
387
|
+
if (plan.kind === "command") {
|
|
388
|
+
print(`${dryRun ? "Would run" : "Running"}: ${plan.display}`);
|
|
389
|
+
if (!dryRun) {
|
|
390
|
+
const r = run(plan.argv[0], plan.argv.slice(1), {
|
|
391
|
+
stdio: "inherit",
|
|
392
|
+
shell: platform === "win32",
|
|
393
|
+
});
|
|
394
|
+
if (r.error || r.status !== 0) {
|
|
395
|
+
failed++;
|
|
396
|
+
print(
|
|
397
|
+
`Could not run the claude CLI (${r.error?.message ?? `exit ${r.status}`}). Install Claude Code or run the command above yourself.`,
|
|
398
|
+
);
|
|
399
|
+
continue;
|
|
400
|
+
}
|
|
401
|
+
}
|
|
402
|
+
print(`Then: ${plan.restart}`);
|
|
403
|
+
continue;
|
|
404
|
+
}
|
|
405
|
+
// file
|
|
406
|
+
print(
|
|
407
|
+
`${plan.uninstall ? "Removing" : "Adding"} "${SERVER_KEY}" ${plan.uninstall ? "from" : "to"} ${plan.path}${plan.existed ? "" : " (new file)"}`,
|
|
408
|
+
);
|
|
409
|
+
if (plan.entry) print(`Entry: ${JSON.stringify(plan.entry)}`);
|
|
410
|
+
if (plan.backupPath) print(`Backup: ${plan.backupPath}`);
|
|
411
|
+
if (dryRun) {
|
|
412
|
+
print("Dry run: nothing written. The file would be:");
|
|
413
|
+
print(plan.text.trimEnd());
|
|
414
|
+
} else {
|
|
415
|
+
applyPlan(plan);
|
|
416
|
+
print("Written. Other settings in the file were left as they were.");
|
|
417
|
+
const cli = CLIENTS[client].cli;
|
|
418
|
+
if (cli && !plan.uninstall)
|
|
419
|
+
print(`VS Code's own format instead: ${cli(platform, hosted)}`);
|
|
420
|
+
}
|
|
421
|
+
print(`Next: ${plan.restart}`);
|
|
422
|
+
print(`Logs if it does not show up: ${plan.logs}`);
|
|
423
|
+
}
|
|
424
|
+
print("");
|
|
425
|
+
print(
|
|
426
|
+
failed
|
|
427
|
+
? `${failed} client${failed === 1 ? "" : "s"} not configured; see above.`
|
|
428
|
+
: `Done. Try it: npx ${PACKAGE_NAME} check`,
|
|
429
|
+
);
|
|
430
|
+
return failed ? 1 : 0;
|
|
431
|
+
}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
// The manifest for the Claude Desktop extension (.mcpb, "Desktop Extensions"),
|
|
2
|
+
// built from the live package so the tool list, version and description can
|
|
3
|
+
// never drift from the server. Spec: github.com/anthropics/mcpb MANIFEST.md,
|
|
4
|
+
// manifest_version 0.3.
|
|
5
|
+
|
|
6
|
+
import { createRequire } from "node:module";
|
|
7
|
+
import { BRAND, PACKAGE_NAME, PACKAGE_VERSION } from "../config.mjs";
|
|
8
|
+
import { toolDefinitions } from "./server.mjs";
|
|
9
|
+
import { prompts } from "./prompts.mjs";
|
|
10
|
+
|
|
11
|
+
const pkg = createRequire(import.meta.url)("../../package.json");
|
|
12
|
+
|
|
13
|
+
export const MANIFEST_VERSION = "0.3";
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* @param {object} ctx a runtime (createRuntime), for the tool and prompt lists
|
|
17
|
+
* @returns {object} manifest.json contents
|
|
18
|
+
*/
|
|
19
|
+
export function buildManifest(ctx) {
|
|
20
|
+
const tools = toolDefinitions(ctx).map((t) => ({
|
|
21
|
+
name: t.name,
|
|
22
|
+
description: t.description.split("\n")[0].trim(),
|
|
23
|
+
}));
|
|
24
|
+
const promptList = prompts(ctx).map((p) => ({
|
|
25
|
+
name: p.name,
|
|
26
|
+
description: p.description,
|
|
27
|
+
arguments: Object.keys(p.argsSchema ?? {}),
|
|
28
|
+
}));
|
|
29
|
+
return {
|
|
30
|
+
manifest_version: MANIFEST_VERSION,
|
|
31
|
+
name: PACKAGE_NAME,
|
|
32
|
+
display_name: BRAND.name,
|
|
33
|
+
version: PACKAGE_VERSION,
|
|
34
|
+
description:
|
|
35
|
+
"Verified dog rules for California and Nevada travel, with the official source and date on every answer.",
|
|
36
|
+
long_description: [
|
|
37
|
+
`Ask Claude whether dogs are allowed at ${ctx.graph.places.length.toLocaleString("en-US")} California and Nevada parks, beaches, trails, hotels, campgrounds and restaurant patios, which hotel will take your dog (weight, number of dogs, nights, pet-fee budget, with the fee math shown), what to do near a town, and where to stop on a highway.`,
|
|
38
|
+
"",
|
|
39
|
+
'Every fact comes from an official source (the agency page or the business\'s own policy) with the date it was checked, and every answer carries a citation. When a source does not state something, the answer says "not stated" instead of guessing.',
|
|
40
|
+
"",
|
|
41
|
+
"The data ships inside the extension and works offline; it refreshes itself from dogpolicies.com when the site has a newer snapshot. No account, no key, no telemetry. Code MIT; data CC BY 4.0.",
|
|
42
|
+
].join("\n"),
|
|
43
|
+
author: { name: BRAND.name, url: BRAND.url },
|
|
44
|
+
repository: { type: "git", url: pkg.repository.url.replace(/^git\+/, "") },
|
|
45
|
+
homepage: `${BRAND.url}/mcp/about/`,
|
|
46
|
+
documentation: `${pkg.homepage}`,
|
|
47
|
+
support: pkg.bugs.url,
|
|
48
|
+
icon: "icon.png",
|
|
49
|
+
server: {
|
|
50
|
+
type: "node",
|
|
51
|
+
entry_point: "bin/dogpolicies-mcp.mjs",
|
|
52
|
+
mcp_config: {
|
|
53
|
+
command: "node",
|
|
54
|
+
args: ["${__dirname}/bin/dogpolicies-mcp.mjs"],
|
|
55
|
+
env: {},
|
|
56
|
+
},
|
|
57
|
+
},
|
|
58
|
+
tools,
|
|
59
|
+
tools_generated: false,
|
|
60
|
+
// Prompt text is built from arguments at run time, so only names are declared.
|
|
61
|
+
prompts: promptList.map(({ name, description, arguments: args }) => ({
|
|
62
|
+
name,
|
|
63
|
+
description,
|
|
64
|
+
arguments: args,
|
|
65
|
+
text: `Use the ${name} prompt from the DogPolicies server${args.length ? ` with ${args.map((a) => `\${arguments.${a}}`).join(", ")}` : ""}.`,
|
|
66
|
+
})),
|
|
67
|
+
prompts_generated: false,
|
|
68
|
+
keywords: [
|
|
69
|
+
"dogs",
|
|
70
|
+
"pet-friendly",
|
|
71
|
+
"travel",
|
|
72
|
+
"hotels",
|
|
73
|
+
"beaches",
|
|
74
|
+
"parks",
|
|
75
|
+
"california",
|
|
76
|
+
"nevada",
|
|
77
|
+
"pet policy",
|
|
78
|
+
],
|
|
79
|
+
license: pkg.license,
|
|
80
|
+
privacy_policies: [`${BRAND.url}/terms/`],
|
|
81
|
+
compatibility: {
|
|
82
|
+
claude_desktop: ">=0.10.0",
|
|
83
|
+
platforms: ["darwin", "win32", "linux"],
|
|
84
|
+
runtimes: { node: ">=20.19.0" },
|
|
85
|
+
},
|
|
86
|
+
};
|
|
87
|
+
}
|