@mcp-guardian/server 1.3.3 → 1.3.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 +26 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
[](LICENSE)
|
|
10
10
|
[](https://github.com/rudraneel93/mcp-guardian/actions/workflows/ci.yml)
|
|
11
11
|
|
|
12
|
-
> **Always use the latest version:** `npm install @mcp-guardian/server@latest` — current is **v1.3.
|
|
12
|
+
> **Always use the latest version:** `npm install @mcp-guardian/server@latest` — current is **v1.3.3**. See the [Changelog](./CHANGELOG.md) for full version history and [GitHub Releases](https://github.com/rudraneel93/mcp-guardian/releases) for per-version source tags.
|
|
13
13
|
|
|
14
14
|
MCP Guardian is a **security and governance proxy** for [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) infrastructure. It sits between AI clients and MCP servers, enforcing active security policies, tracking real token costs, and monitoring health — all while providing enterprise-grade observability and audit trails.
|
|
15
15
|
|
|
@@ -77,6 +77,14 @@ MCP Guardian provides:
|
|
|
77
77
|
- **DPoP (v1.0)** — RFC 9449 sender-constrained token support for replay-proof authentication
|
|
78
78
|
- **OpenTelemetry (v1.0)** — Distributed tracing across proxy and MCP servers via OTLP
|
|
79
79
|
- **HTTP/SSE proxy (v0.8.0)** — Full proxy support for remote HTTP/SSE-based MCP servers
|
|
80
|
+
- **Payload normalization (v1.2.0)** — Multi-stage decoder defeats URL/hex/unicode/HTML entity/shell obfuscation bypass attacks before regex evaluation
|
|
81
|
+
- **Semantic shell analysis (v1.2.0)** — AST-based tokenization detects command substitution, pipe chains, redirects, and 33 dangerous commands semantically
|
|
82
|
+
- **Dashboard authentication (v1.2.0)** — JWT session tokens, API key auth, CSRF protection, and rate-limited login for the web dashboard
|
|
83
|
+
- **mTLS zero-trust networking (v1.3.0)** — Mutual TLS with client certificates for proxy ↔ upstream MCP server communication
|
|
84
|
+
- **E2E proxy tests (v1.3.0)** — Real proxy spawns with `default-policy.yaml`, sends JSON-RPC, verifies block/pass/deny
|
|
85
|
+
- **Supply chain CI (v1.3.0)** — GitHub Actions pipeline with `npm audit --audit-level=high`, CycloneDX SBOM generation, and `.npmrc` enforcement
|
|
86
|
+
- **Operational runbooks (v1.3.0)** — 7 production runbooks covering circuit breaker, Redis, policy corruption, dashboard auth, latency, DB corruption, and token spikes with SLOs
|
|
87
|
+
- **Disaster recovery plan (v1.3.0)** — RTO/RPO for all state types, backup strategy, recovery drills, and rollback procedures
|
|
80
88
|
|
|
81
89
|
---
|
|
82
90
|
|
|
@@ -817,12 +825,16 @@ Token counting uses `tiktoken` with the `o200k_base` encoding (used by GPT-4o an
|
|
|
817
825
|
- [x] Command injection validation (10 suspicious patterns)
|
|
818
826
|
- [x] Active policy engine — YAML-based pass/block/flag with allowlists, regex, rate limiting, token budgets
|
|
819
827
|
- [x] Structured JSON logging (pino) for SIEM ingestion
|
|
820
|
-
- [x] STRIDE threat model (SECURITY.md)
|
|
821
|
-
- [x]
|
|
822
|
-
- [x]
|
|
828
|
+
- [x] STRIDE threat model (SECURITY.md) + formal THREAT_MODEL.md
|
|
829
|
+
- [x] Payload normalization — multi-stage encode/decode bypass defense
|
|
830
|
+
- [x] Semantic shell AST analysis — command substitution, pipe, and dangerous command detection
|
|
831
|
+
- [x] Dashboard authentication — JWT sessions, API keys, CSRF protection
|
|
832
|
+
- [x] mTLS zero-trust networking for proxy ↔ upstream communication
|
|
833
|
+
- [x] 168 tests across 16 suites (unit, fuzz, integration, E2E)
|
|
834
|
+
- [x] GitHub Actions CI (Node 18/20/22 matrix) + supply chain audit
|
|
823
835
|
- [x] Performance benchmarks (p50: 5ms baseline, +25.78ms proxy overhead, +0.15ms policy)
|
|
824
836
|
- [x] Helm chart + production deployment guide (K8s, fail-open/closed, sidecar pattern, scaling)
|
|
825
|
-
- [x] Published to npm as [`@mcp-guardian/server@1.
|
|
837
|
+
- [x] Published to npm as [`@mcp-guardian/server@1.3.3`](https://www.npmjs.com/package/@mcp-guardian/server)
|
|
826
838
|
- [x] OAuth 2.1 / OIDC proxy authentication (v0.5.0)
|
|
827
839
|
- [x] RBAC — scope & client-ID-based access control (v0.5.1)
|
|
828
840
|
- [x] Circuit breaker — 3-state protection for upstream servers (v0.5.2)
|
|
@@ -838,10 +850,16 @@ Token counting uses `tiktoken` with the `o200k_base` encoding (used by GPT-4o an
|
|
|
838
850
|
- [x] DPoP support — RFC 9449 sender-constrained tokens (v1.0)
|
|
839
851
|
- [x] OpenTelemetry tracing — distributed request tracking (v1.0)
|
|
840
852
|
- [x] HTTP/SSE proxy server — remote MCP transport support (v0.8.0)
|
|
841
|
-
- [
|
|
853
|
+
- [x] E2E proxy tests — real CLI spawn with policy file (v1.3.0)
|
|
854
|
+
- [x] Supply chain CI — npm audit, CycloneDX SBOM, npm provenance (v1.3.0)
|
|
855
|
+
- [x] Operational runbooks — 7 scenarios with SLOs (v1.3.0)
|
|
856
|
+
- [x] Disaster recovery plan — RTO/RPO, backup strategy, recovery drills (v1.3.0)
|
|
857
|
+
- [x] GitHub primary language corrected to TypeScript (v1.3.3)
|
|
858
|
+
- [x] npm keywords expanded to 22 terms for discoverability (v1.3.3)
|
|
859
|
+
- [ ] OPA/Rego policy integration
|
|
842
860
|
- [ ] Slack/Discord alerting
|
|
843
|
-
- [ ] Prometheus metrics endpoint
|
|
844
861
|
- [ ] Multi-user proxy
|
|
862
|
+
- [ ] Hosted SaaS version
|
|
845
863
|
|
|
846
864
|
---
|
|
847
865
|
|
|
@@ -849,4 +867,4 @@ Token counting uses `tiktoken` with the `o200k_base` encoding (used by GPT-4o an
|
|
|
849
867
|
|
|
850
868
|
MIT — see [LICENSE](LICENSE) for details.
|
|
851
869
|
|
|
852
|
-
**Built with TypeScript, @modelcontextprotocol/sdk, tiktoken, sql.js, commander, chalk, and
|
|
870
|
+
**Built with TypeScript, @modelcontextprotocol/sdk, tiktoken, sql.js, commander, chalk, zod, jose, pino, and prom-client.**
|