@mcp-guardian/server

security MCP Server

Security, cost, and health governance proxy for MCP infrastructure — YAML policy engine, OAuth 2.1/OIDC, web dashboard, mTLS, semantic shell analysis, STRIDE threat model

VerifiedInstall Ready
securitysecurity
5 views2 stars1 forksv4.1.8MIT

Why This Matters

Discovered via github-topic:mcp and last synced 2mo ago.

VerifiedInstall Ready
Source
github-topic:mcp
Stars
2
Last synced
2mo ago
Install
Instructions detected

Install

1. Install the package

npx @mcp-guardian/server

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "-mcp-guardian-server": {
      "command": "npx",
      "args": [
        "@mcp-guardian/server"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

46
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (46)

Script

Purpose

GUARDIAN_CI_BYPASS_LICENSE

Local dev only: use dashboard without Pro license

analyze

Full security/health report to stdout

harness

Offline adversarial policy matrix (808+ fixtures)

REAL_LIFE_METRICS_ENABLED

Set `false` when running a second proxy alongside `dashboard:proxy`

LIVE_ATTACK_DURATION_MINUTES

Wall-clock duration for `real-life:continuous` (default `60`)

SOC_API_PORT

Legacy standalone SOC API (default `4040`; see [SOC-API.md](SOC-API.md))

MCP_GUARDIAN_HOME

Guardian home dir (semantic store, autopilot config)

Endpoint

Purpose

DASHBOARD_PORT

Dashboard port (default `4000`)

7d

Traffic KPIs, error rate, token/cost series

GUARDIAN_WS_ENABLED

Live WebSocket metrics

Component

Role

Feature

What it does for you

MCP_GUARDIAN_POLICY

Path to your rules file

Area

What you see

Symptom

Fix

MCP_GUARDIAN_MAX_PAYLOAD_BYTES

Max raw JSON-RPC message size (default 10MB)

GUARDIAN_DAILY_BUDGET_USD

Daily spend alert threshold

Requirement

Notes

Transport

Entry module

Variable

Plain meaning

Tier

Features

DASHBOARD_ENABLED

REST API + web UI

Yes

Yes

Command

What it does

GUARDIAN_STRICT_ALLOWLIST_RBAC

Require RBAC on `tools.allow` policy rules

Topic

Document

No

Yes

OLLAMA_BASE_URL

Local LLM endpoint

GUARDIAN_DB_ENCRYPT_AUDIT_ARGS

Also encrypt redacted argument snippets in audit (`true` + key above)

Client

Config file

MCP_GUARDIAN_DB_PATH

Where call history is stored (share this between proxy and test runners)

Cline

`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`

GUARDIAN_MAX_EXPANDED_PAYLOAD_BYTES

Max serialized tool-argument size after decode (default 50MB)

DASHBOARD_AUTH_DISABLED

Skip login on localhost

GUARDIAN_HEALTH_PROBE_INTERVAL_MS

Periodic MCP health probes (0 = disabled)

Autopilot

[docs/AUTOPILOT.md](docs/AUTOPILOT.md)

GUARDIAN_LLM_ENABLED

Semantic / AI features

GUARDIAN_DB_ENCRYPTION_KEY

Encrypt sensitive audit fields at rest

Cursor

`~/.cursor/mcp.json`

GUARDIAN_JWKS_REFRESH_MS

How often to refresh OIDC JWKS (default 5 minutes)

MCP_GUARDIAN_RETENTION_DAYS

How long to keep audit rows (default 30)

GUARDIAN_SHUTDOWN_GRACE_MS

Wait for in-flight calls on shutdown (default 30s)

MCP_GUARDIAN_SIEM_ENABLED

Export block/audit events to Splunk, Datadog, webhooks, etc.

Architecture

[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)