@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.
Files changed (2) hide show
  1. package/README.md +26 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -9,7 +9,7 @@
9
9
  [![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
10
10
  [![CI](https://github.com/rudraneel93/mcp-guardian/actions/workflows/ci.yml/badge.svg)](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.1**. See the [Changelog](./CHANGELOG.md) for full version history and [GitHub Releases](https://github.com/rudraneel93/mcp-guardian/releases) for per-version source tags.
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] 97 tests (13 suites)
822
- - [x] GitHub Actions CI (Node 18/20/22 matrix)
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.1.0`](https://www.npmjs.com/package/@mcp-guardian/server)
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
- - [ ] OPA integration for Rego policies
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 zod.**
870
+ **Built with TypeScript, @modelcontextprotocol/sdk, tiktoken, sql.js, commander, chalk, zod, jose, pino, and prom-client.**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcp-guardian/server",
3
- "version": "1.3.3",
3
+ "version": "1.3.4",
4
4
  "description": "Security, cost, and health audit for MCP infrastructure",
5
5
  "type": "module",
6
6
  "files": [