@yawlabs/caddy-mcp 1.2.3 → 1.2.4
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/README.md +3 -3
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -80,7 +80,7 @@ That's it. Now ask your AI assistant:
|
|
|
80
80
|
|---|---|---|
|
|
81
81
|
| `CADDY_ADMIN_URL` | `http://localhost:2019` | Caddy admin API URL. Set to `http://caddy:2019` inside Docker, or an https URL for remote admin. |
|
|
82
82
|
| `CADDY_API_TOKEN` | (none) | Optional Bearer token for authenticated admin endpoints. Only needed if you've configured Caddy with auth. |
|
|
83
|
-
| `CADDY_MAX_RETRIES` | `2` | Number of retries on transient failures (5xx, network errors). 4xx and 412 never retry. Hard-capped at 5. Set to `0` to disable. |
|
|
83
|
+
| `CADDY_MAX_RETRIES` | `2` | Number of retries on transient failures (5xx, network errors). 4xx and 412 never retry. POSTs to `/config/*` and `/id/*` also skip retry (non-idempotent appends/creates -- retrying could duplicate routes or 409 a half-applied create). POSTs to `/load`, `/adapt`, `/stop` still retry. Hard-capped at 5. Set to `0` to disable. |
|
|
84
84
|
| `CADDY_LOAD_TIMEOUT` | `60000` | Timeout in ms for the `/load` endpoint; raise for ACME-heavy bring-ups where provisioning many certificates can exceed the default. Non-numeric, `<= 0`, or fractional values below 1ms fall back to the default. |
|
|
85
85
|
|
|
86
86
|
**Alternate MCP clients:**
|
|
@@ -134,7 +134,7 @@ Browsable read-only data — MCP clients can fetch these directly without a tool
|
|
|
134
134
|
- `caddy://config` — Current full Caddy JSON configuration.
|
|
135
135
|
- `caddy://servers` — Summary of all configured HTTP servers.
|
|
136
136
|
- `caddy://upstreams` — Reverse proxy upstream health status.
|
|
137
|
-
- `caddy://metrics` — Prometheus metrics (text exposition format).
|
|
137
|
+
- `caddy://metrics` — Prometheus metrics (text exposition format). Capped at the first 500 lines to keep client context bounded; use the `caddy_metrics` tool with `filter` / `max_lines` for filtered or larger output.
|
|
138
138
|
|
|
139
139
|
## Examples
|
|
140
140
|
|
|
@@ -234,7 +234,7 @@ npm install
|
|
|
234
234
|
npm run lint # Biome check
|
|
235
235
|
npm run lint:fix # Auto-fix
|
|
236
236
|
npm run build # tsup bundle
|
|
237
|
-
npm test # Vitest (
|
|
237
|
+
npm test # Vitest (182 unit tests; +8 live-Caddy integration tests gated by CADDY_MCP_INTEGRATION=1)
|
|
238
238
|
npm run typecheck # tsc --noEmit
|
|
239
239
|
```
|
|
240
240
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@yawlabs/caddy-mcp",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.4",
|
|
4
|
+
"mcpName": "io.github.YawLabs/caddy-mcp",
|
|
4
5
|
"description": "MCP server for managing Caddy web servers via the admin API",
|
|
5
6
|
"license": "MIT",
|
|
6
7
|
"author": "Yaw Labs <contact@yaw.sh> (https://yaw.sh)",
|