fix: standardize shx dependency format in package.json
This commit is contained in:
parent
959afa4dda
commit
10e8e8deaa
11
.github/PULL_REQUEST_TEMPLATE/mcpcat.md
vendored
11
.github/PULL_REQUEST_TEMPLATE/mcpcat.md
vendored
@ -3,22 +3,28 @@
|
||||
> **TL;DR**: This PR adds an **opt-in** flag to scaffold privacy-safe analytics wiring for MCPcat in projects generated by `openapi-mcp-generator`.
|
||||
|
||||
## Summary
|
||||
|
||||
This PR introduces a `--with-mcpcat` CLI flag that scaffolds:
|
||||
|
||||
- A tiny analytics shim to emit initialize/tool-call events.
|
||||
- A default **local redaction** helper to scrub sensitive data before export.
|
||||
- Minimal config via environment variables.
|
||||
No behavior changes unless the flag and env vars are set.
|
||||
No behavior changes unless the flag and env vars are set.
|
||||
|
||||
## Motivation
|
||||
|
||||
- Make freshly generated MCP servers **observable in minutes**.
|
||||
- Encourage **privacy-by-default** analytics patterns.
|
||||
- Reduce copy/paste wiring; standardize event shape (operationId, path, duration, status).
|
||||
|
||||
## Changes
|
||||
|
||||
### CLI
|
||||
|
||||
- `generate` accepts `--with-mcpcat` (default: off).
|
||||
|
||||
### Template files (added conditionally)
|
||||
|
||||
- `src/analytics/mcpcat.ts` – lazy import + safe no-op if SDK absent.
|
||||
- `src/analytics/redact.ts` – OpenAPI-aware heuristics (e.g., `*token*`, `password`, `apiKey`, `authorization`, `email`).
|
||||
- `src/analytics/config.ts` – reads env:
|
||||
@ -28,6 +34,7 @@ No behavior changes unless the flag and env vars are set.
|
||||
- `MCPCAT_SAMPLE_RATE=1.0` (0–1)
|
||||
|
||||
### Server wiring
|
||||
|
||||
- Hooks server `.initialize` and each tool invocation to record:
|
||||
- `operationId`, HTTP `method`, `path`
|
||||
- redacted `args`
|
||||
@ -35,9 +42,11 @@ No behavior changes unless the flag and env vars are set.
|
||||
- `duration_ms`
|
||||
|
||||
### Docs
|
||||
|
||||
- Adds a “Enable analytics (MCPcat)” section to generated README with privacy notes and quickstart.
|
||||
|
||||
## Implementation Notes
|
||||
|
||||
- **Compile-time optional**: no imports unless flag is used.
|
||||
- **Runtime safe**: try/catch around SDK import → graceful no-op if not installed.
|
||||
- **Transport-agnostic**: compatible with stdio, SSE/web, and StreamableHTTP templates.
|
||||
|
||||
@ -40,7 +40,7 @@ export function generatePackageJson(
|
||||
devDependencies: {
|
||||
'@types/node': '^22.15.2',
|
||||
typescript: '^5.8.3',
|
||||
"shx": "^0.4.0",
|
||||
shx: '^0.4.0',
|
||||
},
|
||||
};
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user