mcpry
mcpry is a command-line tool for analyzing MCP servers. It does the following:
- Discovers MCP Servers: It automatically searches for MCP server configuration files in well-known locations on the host system.
- Analyzes Tools and Resources: It connects to each discovered server to fetch the list of available tools and resources.
- Security Scanning with Pangea AI Guard: It uses the Pangea AI Guard service to scan the tools for malicious entities and prompts.
- Generates Reports: It creates a JSON report (default
mcpry.json) containing the analysis results. - Detects Changes: It can compare the current state of a server's tools with a previous report and display a diff if any changes are detected.
- Finds Similar Tools: It can identify tools with similar functionality.
Installation
pip install -U mcpry
Configuration
Before using mcpry, you need to set the PANGEA_AI_GUARD_TOKEN environment
variable to a Pangea API token that has access to the Pangea
AI Guard service.
export PANGEA_AI_GUARD_TOKEN="pts_your_token_here"
Usage
The primary command is scan, which runs the analysis.
mcpry scan
Options
| Parameter | Description | Default |
|---|---|---|
--input <PATH> |
The input file containing a previous report to compare against. | mcpry.json |
--output <PATH> |
The file where the new report will be saved. | mcpry.json |
--list-tools |
If set, the names of all tools for each MCP server will be listed in the output. | False |
--mcp-config-files <FILES> |
A list of files to discover MCP servers from. | A list of well-known paths for different operating systems. |
--similarity-threshold <FLOAT> |
The threshold (between 0.0 and 1.0) for two tools to be considered similar. | 0.96 |
--syntax-theme <THEME> |
The syntax theme to use for displaying JSON diffs. | github-dark |
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mcpry-0.2.0.tar.gz
(6.4 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
mcpry-0.2.0-py3-none-any.whl
(7.2 kB
view details)
File details
Details for the file mcpry-0.2.0.tar.gz.
File metadata
- Download URL: mcpry-0.2.0.tar.gz
- Upload date:
- Size: 6.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bae0fea873e4c8b34d18ad26767c57d8ab433ad3a6c0251db6e63b1a054c492a
|
|
| MD5 |
8fc606ed6ace8d18fd9a5ae85e58ef57
|
|
| BLAKE2b-256 |
9eb3c850fa537f5b72c37142a6e8a2c9140116144b96b97192622b41c99bd281
|
File details
Details for the file mcpry-0.2.0-py3-none-any.whl.
File metadata
- Download URL: mcpry-0.2.0-py3-none-any.whl
- Upload date:
- Size: 7.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
43e93fc49a687568754fa1ae0766b59d124fef9b80cabd78540cc3a6a9fa6165
|
|
| MD5 |
e82d1aede1dcb4d04e8afee33951f8f5
|
|
| BLAKE2b-256 |
e207c85abac94966404db22821ffe057518fce2064798e86f64a5e4e3a6c6743
|