Installing - Linux
This page explains how to install MCP Guardian on Linux using prebuilt binaries from Github Releases.
[1] Install mcp-guardian
Download
mcp-guardian_x86_64-linux.AppImage
or
mcp-guardian_x86_64-linux
The AppImage is much easier to use, but if you know how to get dependencies installed properly the native binary is provided as another option.
Rename the binary and make it executible:
mv mcp-guardian_x86_64-linux.AppImage mcp-guardian.AppImage
chmod +x mcp-guardian.AppImage
To test it works on your system, double click it from a file explorer that can launch executables or launch it from the command line. You should see the GUI window open.
[2] Install mcp-guardian-proxy
Download
mcp-guardian-proxy_x86_64-linux
Rename the binary and make it executible:
mv mcp-guardian-proxy_x86_64-linux mcp-guardian-proxy
chmod +x mcp-guardian-proxy
We recommend you place mcp-guardian-proxy
somewhere in your system's PATH
so it can be more conveniently used by MCP Guardian, however this is not required.
Test it works on your system:
mcp-guardian-proxy --help
You should see a help message with usage.
[Optional] Install mcp-guardian-cli
The MCP Guardian GUI (mcp-guaridan
) and mcp-guardian-proxy
are all that need be installed to use MCP Guardian, but mcp-guardian-cli
is available for users who would prefer a terminal based workflow to the GUI.
Download
mcp-guardian-cli_x86_64-linux
Rename the binary and make it executible:
mv mcp-guardian-proxy_x86_64-linux mcp-guardian-proxy
chmod +x mcp-guardian-proxy
Test it works on your system:
mcp-guardian-cli --help
You should see a help message with usage.
After Installing
Once you have binaries installed on your system, see the Tutorial to quickly get up and running with MCP Guardian.