Back to MCP directory
publicPublicdnsLocal runtime

mcp-guardian

MCP Guardian是一个管理LLM助手访问MCP服务器的工具,提供实时控制、消息日志、审批和自动化安全检查功能。

article

README

🚀 MCP 守护者

MCP 守护者可管理您的 LLM 助手对 MCP 服务器的访问权限,让您能实时控制 LLM 活动。同时,它还能让管理多个 MCP 服务器配置变得轻松简单。

https://mcp-guardian.org

🚀 快速开始

项目概述

MCP 守护者管理您的 LLM 助手对 MCP 服务器的访问权限,为您提供实时控制您的 LLM 活动的能力。它还具备以下特性:

  • 📜 消息日志:查看所有 LLM 的 MCP 服务器活动记录。
  • 💂 消息审批:实时批准和拒绝单个工具调用消息。
  • 🤖 自动化消息扫描:实时自动化检查安全性、隐私等(即将推出)。

此外,MCP 守护者还使管理多个 MCP 服务器配置变得轻而易举。无需手动管理 MCP 主机应用程序的配置文件,即可快速在服务器集合之间切换。

开发环境

此项目使用 nix 来管理开发环境,可用于 Linux 和 macOS。

快速入门 - Linux / macOS

  1. 安装 nix:访问 https://nixos.org/download/ 进行安装。
  2. 启用 nix flakes
sudo sh -c 'echo "experimental-features = nix-command flakes" >> /etc/nix/nix.conf'
  1. 进入开发 Shell
nix develop
  1. 构建项目
just build-release
  1. mcp-guardianmcp-guardian-proxy 现在位于 _build/bin/ 中,该路径已添加到开发 Shell 的 PATH 环境变量中。

快速入门 - Windows

  1. 安装 git:访问 https://git-scm.com/downloads/win 进行安装,并启用符号链接支持(否则在构建之前需要手动恢复 ./mcp-guardian/bindings)。
  2. 安装 rustup:访问 https://www.rust-lang.org/tools/install 进行安装。
  3. 安装 nodejs:访问 https://nodejs.org/en/download 进行安装。
  4. 安装 yarn
npm install --global yarn
  1. 安装 .dll 依赖项:最简单的方法是安装 Visual Studio 并安装 C++ 开发包。
  2. 安装 just
cargo install just
  1. 使用 git-bash 进入仓库根目录(否则 just 无法使用,需要直接调用 cargo)。
  2. 构建项目
just build-release

Justfile

present just --list
可用配方:
    build
    build-release
    clean
    do DIR +RECIPE
    do-all +RECIPE
    fmt
    fmt-check
    lint
    readme-check
    readme-update
    test
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client