MCP Guardian

mcp-guardian.org

Overview

MCP Guardian provides real-time control over your LLM assistant's interactions with MCP servers. It allows you to manage and monitor your LLM's activity, ensuring safety and security.

Message Logging - Tracks all MCP server activity initiated by the LLM.

Message Approvals - Enables real-time approval or denial of individual tool call messages.

Automated Message Scans - (Coming Soon) Implements automated checks for safety, privacy, and other criteria.

<p align="center"> <img src="./docs/src/resources/splash-page.png" /> </p>

MCP Guardian simplifies the management of multiple MCP server configurations, allowing quick switching between server collections without manual configuration file management.

Development

The project uses nix for development environment management on Linux and macOS. Windows development requires git, rustup, nodejs, and yarn. The just task runner automates common development tasks.

Quick Start - Linux / macOS

1. Install nix
2. Enable nix flakes

sudo sh -c 'echo "experimental-features = nix-command flakes" >> /etc/nix/nix.conf'

3. Enter dev shell

nix develop

4. Build project

just build-release

5. mcp-guardian and mcp-guardian-proxy are now in _build/bin/ which is in PATH of the dev shell.

Quick Start - Windows

1. Install git with symlink support.
2. Install rustup.
3. Install nodejs.
4. Install yarn.

npm install --global yarn

5. Install .dll dependencies via Visual Studio.
6. Install just

cargo install just

7. Enter repo root with git-bash.
8. Build project

just build-release

Justfile

Available recipes:
    build
    build-release
    clean
    do DIR +RECIPE
    do-all +RECIPE
    fmt
    fmt-check
    lint
    readme-check
    readme-update
    test