mcp-checkpoint 1.0.0

A comprehensive MCP configuration scanner with client-aware security analysis

MCP Checkpoint

:rocket: Overview

MCP Checkpoint is a comprehensive security scanner for Model Context Protocol (MCP). Automatically discovers, analyzes, and secures MCP servers integrated with all major Agentic IDEs, Agents and Clients.

:bulb: Features

• 🔍 Auto-Discovery: Finds known MCP configurations for popular Agentic IDEs like Cursor, Windsurf, VS Code, Claude Desktop, and more
• 🔧 Tool & Resource Inventory: Connects to MCP servers and catalogs available tools and resources
• 🛡️ Security Analysis: Specialized security checks including prompt injection, Cross-server Tool Shadowing, Tool poisoning, Tool name ambiguity, and more..
• 📊 Comprehensive Reporting: JSON and Markdown reports with actionable security recommendations

:toolbox: Installation

pip install mcp-checkpoint

:running: Quick Start

# Scan all configurations with security analysis
mcp-checkpoint scan

# Inspect configurations without security scanning
mcp-checkpoint inspect

# Use custom configuration file
mcp-checkpoint scan --config /path/to/config.json

# Scan multiple configuration files
 mcp-checkpoint scan \
   --config /path/to/cursor.mcp.json \
   --config /path/to/vscode.mcp.json

# Generate markdown report
mcp-checkpoint scan --report-type md

# Save to custom file
mcp-checkpoint scan --output my-report.json
mcp-checkpoint scan --report-type md --output my-report.md

:gear: Command Options

Option	Description
--config	Custom configuration file path
--report-type {json,md}	Output format (default: json)
--output	Custom output file path
--verbose	Detailed terminal output
--show-logs	Display debug logs in terminal

:beginner: Security Checks

• Prompt Injection
• Indirect Prompt Injection
• Cross-Server Tool Shadowing
• Tool Poisoning
  • Prompt Injection in Tool Description, Name and Args
  • Command Injection in Tool Description, Name and Args
• Tool Name Ambiguity
• Command Injection
• Excessive Tool Permissions
• Hardcoded Secrets

:page_with_curl: Logging

Logs are automatically saved to logs/mcp_checkpoint.log:

# Default: logs saved to file only
mcp-checkpoint scan

# Show logs in terminal too
mcp-checkpoint scan --show-logs

:test_tube: Demo

Test MCP Checkpoint using our intentionally vulnerable MCP servers. For details, see the demo guide.

:star2: Community

Join our Slack - a space for developers and security engineers building together to secure AI agents.

:question: FAQs

Q: Is my source code ever shared, or does everything run locally?

MCP Checkpoint runs entirely locally. Inspect and scan modes analyze your MCP configurations, detect MCP servers integrated with your agents, and evaluate them directly on your machine. Prompt injection checks use our open-source model Aira-security/FT-Llama-Prompt-Guard-2, downloaded from Hugging Face to your local environment, ensuring your data and code is never shared externally.

:balance_scale: License

Distributed under the Apache 2.0 License. See LICENSE for more information.