返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端