MCP Guardian MCP Server

by rudraneel93io.github.rudraneel93/mcp-guardianv2.3.21

Security and governance proxy for MCP with YAML policies (blocklists, rate limits, token budgets), token cost tracking, health monitoring and RBAC.

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install MCP Guardian MCP server

claude mcp add mcp-guardian -e ALERT_WEBHOOK_URL='<alert-webhook-url>' -- npx -y @mcp-guardian/server

{
  "mcpServers": {
    "mcp-guardian": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-guardian/server"
      ],
      "env": {
        "ALERT_WEBHOOK_URL": "<alert-webhook-url>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mcp-guardian": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-guardian/server"
      ],
      "env": {
        "ALERT_WEBHOOK_URL": "<alert-webhook-url>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mcp-guardian": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mcp-guardian/server"
      ],
      "env": {
        "ALERT_WEBHOOK_URL": "<alert-webhook-url>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mcp-guardian": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-guardian/server"
      ],
      "env": {
        "ALERT_WEBHOOK_URL": "<alert-webhook-url>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MCP_GUARDIAN_DB_PATH	—	—	Path to SQLite history database
ALERT_WEBHOOK_URL	—	yes	Slack or Discord webhook for critical alerts
METRICS_ENABLED	—	—	Expose Prometheus metrics

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-06-07 · 4mo ago · GitHub
Latest release
2026-05-13 · 5mo ago · GitHub · v2.3.20
Package published
no data · npm/PyPI
Registry entry updated
2026-05-14 · 5mo ago · official registry · v2.3.21

FAQ

›How do I install the MCP Guardian MCP server in Claude Code?

Run: claude mcp add mcp-guardian -e ALERT_WEBHOOK_URL='<alert-webhook-url>' -- npx -y @mcp-guardian/server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does MCP Guardian require an API key?

Yes. It expects ALERT_WEBHOOK_URL, of which 1 is a secret.

›Can I use MCP Guardian as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is MCP Guardian in the official MCP registry?

Yes, as io.github.rudraneel93/mcp-guardian.