📌Overview

Purpose: MCP Guardian aims to manage and control LLM assistants' access to MCP servers, providing real-time oversight and flexibility in LLM operations.

Overview: MCP Guardian enables users to effectively monitor and adjust their LLM's interactions with MCP servers. It streamlines the management of server configurations and enhances user control over LLM activities.

Key Features:

📜 Message Logging: Tracks and displays all MCP server activities performed by the LLM, ensuring transparency and accountability.
💂 Message Approvals: Allows users to approve or deny specific tool call messages in real-time, granting immediate control over LLM actions.
🤖 Automated Message Scans: (Coming Soon) Offers real-time automated checks for safety and privacy concerns to enhance user trust and LLM reliability.

MCP Guardian

https://mcp-guardian.org

Overview

MCP Guardian manages your LLM assistant's access to MCP servers, giving you real-time control over your LLM's activity.

📜 Message Logging - See traces for all of an LLM's MCP server activity
💂 Message Approvals - Approve and deny individual tool call messages in real time
🤖 Automated Message Scans - Real-time automated checks for safety, privacy, etc. (Coming Soon)

MCP Guardian also simplifies managing multiple MCP server configurations. Quickly switch between server collections without manually managing configuration files for your MCP host applications.

Development

This project uses nix to manage a development environment compatible with Linux and macOS.

Quick Start - Linux / macOS

Install nix: https://nixos.org/download/

Enable nix flakes

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

Enter dev shell
```
nix develop
```
Build project
```
just build-release
```
mcp-guardian and mcp-guardian-proxy executables will be in _build/bin/, which is in the dev shell's PATH.

Quick Start - Windows

Install git with symlink support: https://git-scm.com/downloads/win
Install rustup: https://www.rust-lang.org/tools/install
Install nodejs: https://nodejs.org/en/download
Install yarn:
```
npm install --global yarn
```
Install .dll dependencies by installing Visual Studio and selecting the C++ development packages.
Install just:
```
cargo install just
```
Enter repo root with git-bash (needed for just to work properly).
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