← 返回目录

MCP Scanner

官方

非标准 Server

扫描 MCP 服务器以发现潜在威胁和安全问题。

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 315 / 438
Stars: ★ 1.1k 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.11+ · Docker
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 4 天前

44FMRS · D

MCP Scanner 是一个功能全面的安全扫描工具，适用于 MCP 服务器的安全评估。它提供了多种分析引擎和丰富的功能，但可能需要一些配置才能完全使用。

最强项 · 文档质量 15/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

7/20

维护活跃度

8/20

文档质量

15/20

安装易用性

10/20

查看各项评分依据

可靠性 4/20: 证据仅来自 README 和仓库元数据，未提供 server manifest、源码、测试或 CI。README 描述的是 CLI/REST 扫描器，未展示 MCP 初始化握手、工具列表或实际行为验证；因此无法确认其作为 MCP server 能干净启动、工具声明与真实行为一致。扣分主要在于缺少可复现的握手/测试证据及错误路径说明。
安全与权限 7/20: 未发现恶意代码、真实密钥泄露或隐蔽外传等红线问题；README 也说明 VirusTotal 上传默认关闭。但源码不在证据范围内，无法验证凭据存储方式、最小权限原则、发送内容到 Cisco/LLM/VirusTotal 时的数据边界，以及危险操作的二次确认机制。因此安全边界和确认机制证据不足，予以扣分。
维护活跃度 8/20: 仓库未归档，使用 Apache-2.0 许可证，由 Cisco 维护且仍有开放 issues，README 显示通过 PyPI 分发，说明项目尚在维护。但证据中没有提交历史、发布记录、CI 状态、依赖更新节奏或安全响应渠道，无法证明持续的版本治理与维护承诺，故按缺失证据扣分。
文档质量 15/20: README 内容非常详细，涵盖安装、环境变量、CLI/SDK/API 示例、输出格式、日志控制、docs/ 文档目录等，覆盖面广，质量较高。但缺少作为 MCP server 本身的 server manifest、工具参数清单、主流客户端配置示例，以及面向该 server 角色的明确限制与故障排除章节，因此未给满分。
安装易用性 10/20: Python 3.11+/uv 的安装路径清晰，并给出大量快速开始命令及跨平台说明；但未提供主流 MCP 客户端（如 Claude Desktop）连接本仓库作为 MCP server 的配置示例，也无 CI/测试可验证安装后能正常连接。按静态校准最多不超过 15，且存在手动/脆弱风险，故给 10。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码访问网络

适合谁

需要确保 MCP 服务器安全性的安全团队。
在部署前检查 MCP 服务器漏洞的开发者。
希望将安全扫描集成到 CI/CD 管道中的组织。

不适合谁

寻找 MCP 服务器实现或客户端的人。
需要实时监控或主动防御解决方案的用户。
对商业 API 或外部服务有严格隐私要求的组织。

所需权限

需要访问 Cisco AI Defense API 密钥（可选）。
需要 LLM 提供商的 API 密钥（可选，用于 LLM 分析器）。
需要 VirusTotal API 密钥（可选，用于恶意软件扫描）。

风险与副作用

依赖外部 API 服务，可能存在数据隐私问题。
扫描可能会产生误报或漏报。
安装后需要正确配置环境变量，否则可能无法运行。

安装接入

准备工作

运行环境：Python 3.11+ · Docker

MCP_SCANNER_API_KEY 可选密钥 Cisco AI Defense API 密钥，仅 API 分析器需要，来自 Cisco AI Defense 控制台。

MCP_SCANNER_LLM_API_KEY 可选密钥 LLM 提供商 API 密钥（OpenAI/Bedrock 等）；本地 LLM 也需设置但可为任意值。

VIRUSTOTAL_API_KEY 可选密钥 VirusTotal API 密钥，用于文件/目录恶意软件哈希查询，可在 virustotal.com 免费获取。

其他可选配置项（12 个）

MCP_SCANNER_ENDPOINT 可选 Cisco AI Defense inspect API 的基础 URL，默认美国区端点。

MCP_SCANNER_LLM_MODEL 可选 LiteLLM 支持的模型名，如 gpt-5.2 或 Bedrock Claude 模型 ID。

MCP_SCANNER_LLM_BASE_URL 可选自定义 LLM 端点，Azure OpenAI 或 Azure Foundry 时需要。

MCP_SCANNER_LLM_API_VERSION 可选 Azure OpenAI 等 API 版本字符串。

MCP_SCANNER_LLM_TIMEOUT 可选 LLM 调用超时秒数，扩展思考模型建议设为 300。

MCP_SCANNER_LLM_ENDPOINT 可选本地 LLM（Ollama/vLLM 等）的端点地址。

AWS_PROFILE 可选通过 AWS 凭证配置文件使用 Bedrock 时的 AWS 配置文件名。

AWS_REGION 可选 AWS Bedrock 调用所需区域，如 us-east-1。

MCP_SCANNER_VIRUSTOTAL_ENABLED 可选设为 false 可在保留 API key 的情况下禁用 VirusTotal 扫描（如 CI 中）。

MCP_SCANNER_VIRUSTOTAL_UPLOAD_FILES 可选是否上传未知文件到 VirusTotal，默认 false。

MCP_SCANNER_VT_MAX_FILES 可选每个目录扫描的最大文件数，默认 10，0 表示不限。

MCP_SCANNER_STDIO_TIMEOUT 可选 stdio MCP 服务器启动超时秒数，默认 60，重型依赖服务器可调大。

使用 uv 安装：

uv tool install --python 3.13 cisco-ai-mcp-scanner

或者从源码安装：

git clone https://github.com/cisco-ai-defense/mcp-scanner
cd mcp-scanner
uv sync --python 3.13

验证是否装好

安装后运行 `mcp-scanner --scan-known-configs --analyzers yara --format summary`，无需任何 API key，能输出本机已知 MCP 配置中各服务器的扫描摘要即表示安装成功。

常见排障

确保 Python 3.11+ 和 uv 已安装。
检查环境变量是否正确设置：MCP_SCANNER_API_KEY、MCP_SCANNER_LLM_API_KEY 等。
对于远程服务器，确认服务器 URL 可访问且认证配置正确。

使用场景

在部署前扫描 MCP 服务器的工具、提示词、资源和指令以发现安全发现。

在 CI/CD 管道中扫描离线 JSON 文件以进行静态安全分析。

分析 MCP 服务器的源代码以检测恶意行为。

扫描 PyPI 或 npm 包以查找隐藏的恶意行为。

详细介绍

MCP Scanner 是一个 Python 工具，用于扫描 MCP（模型上下文协议）服务器和工具，查找潜在的安全问题。它结合了 Cisco AI Defense 检查 API、YARA 规则和 LLM 作为评审，以检测恶意的 MCP 工具。该工具支持多种模式，包括 CLI 和 REST API 服务器，并提供多引擎安全分析、漏洞包扫描、就绪扫描、行为代码扫描、VirusTotal 二进制恶意软件扫描、PyPI 包扫描、静态/离线扫描等功能。它适用于需要确保 MCP 服务器安全性的开发者和安全团队。