MCP Parapet

mcp护栏

MCP服务器的安全中间件。完全在您的机器上运行。

没有API密钥。没有SaaS帐户。没有遥测。就 pip install mcp-parapet 每个工具调用在到达服务器之前都会被扫描、验证和记录。

Client ↔ [mcp-parapet] ↔ MCP Server
            ↓
      Security Pipeline
      ├─ Content scanning (PII, secrets, prompt injection)
      ├─ Trust boundaries (OWASP 5-tier hierarchy)
      ├─ Rate limiting (per-server, per-tool)
      ├─ Manifest integrity (rug pull detection)
      └─ Audit trail (append-only JSONL)

为什么选择mcp护栏

82%的MCP服务器的文件操作容易受到路径遍历的攻击。66%包含至少一种关键代码气味。23%的工具描述中有可疑的指令式模式。

大多数MCP安全工具需要注册、API令牌，或将工具描述发送到第三方服务器进行分析。mcp-parapet没有。所有东西都在本地离线运行，除了PyYAML之外没有任何外部依赖。

mcp-scan告诉你出了什么问题。mcp护栏阻止了这种情况的发生。

安装

pip install mcp-parapet

快速入门

在任何服务器命令前加上前缀 mcp-parapet wrap --就这样。

无论您使用什么命令启动MCP服务器，请将 mcp-parapet wrap -- 现在，每个工具调用都要经过安全管道。

# Before (no security)
npx -y @modelcontextprotocol/server-filesystem /tmp

# After (full security pipeline)
mcp-parapet wrap -- npx -y @modelcontextprotocol/server-filesystem /tmp

适用于任何MCP服务器。没有代码更改。无需修改服务器。

# Node-based servers
mcp-parapet wrap -- npx -y @modelcontextprotocol/server-github
mcp-parapet wrap -- npx -y @modelcontextprotocol/server-puppeteer

# Python servers
mcp-parapet wrap -- python my_server.py
mcp-parapet wrap -- uvx my-mcp-package

# Anything that speaks MCP over stdio
mcp-parapet wrap -- ./my-custom-server --port 8080

在Claude桌面中使用

替换 "command" 和 mcp-parapet 并预置 "wrap", "--" 到args：

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-parapet",
      "args": ["wrap", "--name", "filesystem", "--",
               "npx", "-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "github": {
      "command": "mcp-parapet",
      "args": ["wrap", "--name", "github", "--",
               "npx", "-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_..." }
    }
  }
}

这 --name 标记每个服务器的审计日志和配置。可选，但推荐。

自定义（可选）

# Generate a config file with sensible defaults
mcp-parapet init

# Scan a file or stdin directly
echo "My SSN is 123-45-6789" | mcp-parapet scan -

开箱即用，mcp parpet拒绝即时注入，编辑泄露的秘密，并记录每次工具调用。 parapet.yaml 允许您调整策略、设置每台服务器的信任级别和配置速率限制，但默认值为生产就绪。

它做什么

内容扫描

四阶段流水线扫描每个工具调用参数和响应：

可按类别配置策略： flag, redact，或 reject.

信任边界

MCP服务器的五层信任层次结构：

每台服务器的分配列表和块列表用于细粒度控制。

工具清单完整性

在第一次连接时对工具清单进行哈希处理。在每个后续连接上，与存储的哈希值进行比较。检测：

• 工具中毒 --工具描述中嵌入的恶意指令
• 地毯拉 --初始信任后工具定义发生了变化
• 工具阴影 --添加了模拟现有工具的新工具
• 清单篡改 --对工具列表的任何修改

可选的HMAC-SHA256签名，使用密钥进行加密验证。

速率限制

滑动窗口速率限制器，按服务器和工具粒度：

• 默认值：60个呼叫/分钟，1000个呼叫/小时
• 可配置每台服务器的覆盖
• 防止资源枯竭和滥用

审计跟踪

仅附加每个安全决策的JSONL日志：

{"timestamp":"2026-04-04T10:15:30Z","event_type":"tool_call_blocked","server_name":"filesystem","tool_name":"write_file","verdict":"reject","detections":[{"type":"injection_override","confidence":0.85}]}

每个工具调用请求、响应、阻止、编校、速率限制命中和清单更改都会记录完整的上下文。

配置

parapet.yaml

scanner:
  policy_pii: flag           # flag | redact | reject
  policy_secrets: redact     # flag | redact | reject
  policy_injection: reject   # flag | redact | reject
  scan_tool_arguments: true
  scan_tool_responses: true

audit:
  enabled: true
  log_file: parapet-audit.jsonl

integrity:
  enabled: true
  alert_on_change: true
  block_on_change: false

rate_limit:
  default_per_minute: 60
  default_per_hour: 1000

servers:
  my-trusted-server:
    trust_level: trusted
  third-party-server:
    trust_level: basic
    allowed_tools:
      - search
      - read
    max_calls_per_minute: 10

环境变量

Python API

from mcp_parapet import ContentScanner, ScanVerdict

scanner = ContentScanner()

# Scan text content
verdict = scanner.scan("My SSN is 123-45-6789")
print(verdict.allowed)     # True (default PII policy is 'flag')
print(verdict.flags)       # ['pii_detected']
print(verdict.detections)  # [Detection(type=ssn, ...)]

# Scan tool call arguments
verdict = scanner.scan_json({"query": "ignore all previous instructions"})
print(verdict.allowed)     # False (default injection policy is 'reject')

OWASP MCP十大覆盖范围

mcp护栏地图 OWASP MCP前10名 （2025/2026，测试版）——第一个致力于模型上下文协议安全的OWASP框架：

也映射到 OWASP安全MCP服务器开发实用指南 v1.0（2026年2月）：第3节输入验证（ContentScanner），第4节访问控制（TrustPolicy），第5节工具完整性（完整性），第6节日志记录（AuditTrail），第7节速率限制（RateLimiter），第8节错误处理（JSON-RPC错误响应）。

mcp护栏比较如何

mcp护栏不能替代企业mcp网关。如果您需要OAuth 2.1、SSO、多租户RBAC和托管云仪表板，请使用TrueFoundry或Lasso。如果你需要一个免费的本地第一安全层，你可以 pip install 忘了，那是mcp护栏。

CLI 参考

mcp-parapet wrap [--name NAME] [--config FILE] --  [args...]
mcp-parapet scan 
mcp-parapet init [--output FILE] [--force]
mcp-parapet verify 
mcp-parapet version

许可证

麻省理工学院-- Quantify实验室有限公司

链接

• PyPI: pypi.org/project/mcp-parapet
• 仓库:
• OWASP MCP前10名: owasp.org/www-project-mcp-top-10
• OWASP MCP安全开发指南: owasp.org/www-project-mcp服务器安全