AI导哈

MCP配置静态扫描器

MCP Preflight是一款用于Model Context Protocol设置的本地静态扫描器，可审查MCP配置、提示文本、工具描述和仓库清单，并在运行新设置或部署代理工作流前标记风险模式。

  • by TimesAndPlaces
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 TimesAndPlaces/mcp-preflight

使用说明

MCP飞行前

MCP Preflight是一个用于模型上下文协议设置的本地静态扫描器。

它审查MCP配置、提示文本、工具描述和仓库清单，然后在运行新设置或发布代理工作流之前标记风险模式。

默认扫描保留在磁盘上。它不连接到服务器或执行工具。

Lite是免费的，本地的，包括抑制文件。Pro添加了报告、CI模式、Git挂钩和策略预设。

网站： mcpprefleight.com

安装

Surface 最适合 得到它
VS代码扩展 编辑器工作流程 VS代码市场 或 打开VSX
npm CLI 终端工作流程 npm install -g mcp-preflight
独立CLI 单个下载文件 下载 mcp-preflight.js 从 GitHub 发布

开始

选择一条适合你想要尝试的道路。

1.VS代码扩展

这是在真实工作空间中尝试它的最快方法。

  1. 从以下位置安装MCP Preflight VS代码市场 或 打开VSX.
  2. 打开要查看的工作区。
  3. 从活动栏打开MCP Preflight侧栏，或单击MCP Preflights状态项。
  4. 跑 MCP Preflight: Scan Workspace.
  5. 在侧栏、概述和问题面板中查看结果。

2.来自npm的CLI

只需安装一次，即可在任何地方运行。

npm install -g mcp-preflight
mcp-preflight scan /path/to/workspace

如果你想在不进行全局安装的情况下尝试它：

npx mcp-preflight scan /path/to/workspace

有关命令帮助：

mcp-preflight --help

3.GitHub发布的独立CLI

如果您希望下载单个文件而不是全局安装，请使用此选项。

node mcp-preflight.js scan /path/to/workspace

4.从此存储库运行

如果您想检查代码、尝试捆绑的示例工作区或处理项目本身，请使用此选项。

  1. 克隆存储库。
  2. 跑 npm install.
  3. 跑 npm run quickstart.
  4. 跑 npm run scan -- /path/to/your/workspace.

npm run quickstart 扫描中的捆绑示例工作区 demo/example-findings-workspace 因此，在扫描自己的项目之前，您可以看到一个具有代表性的查找集。

它评论了什么

  • .vscode/mcp.json 以及其他常见的MCP配置位置
  • 工具描述和提示资源
  • 回购清单和依赖关系信号
  • 明显的秘密文件，如 .env
  • 风险模式，如凭证暴露、令牌传递、浮动临时启动器、不安全的远程目标、快速注入、工具中毒和范围过广

人们为什么使用它

  • 在首次信任之前，它为您提供了一个本地审查步骤。
  • Lite无需帐户即可工作。
  • 研究结果解释了什么看起来有风险，接下来要改变什么。
  • Lite包含本地抑制文件，因此您可以调整信号，而无需付费从噪声中恢复。
  • 它仍然专注于MCP审查，而不是试图成为一个通用的安全平台。

Lite和Pro

  • Lite为您提供核心本地扫描、文本和JSON输出、工作区和当前文件扫描以及本地抑制文件。
  • Pro为该扫描添加了报告、CI模式、Git挂钩和策略预设。
  • Pro使用已签名的本地许可证令牌解锁。它不需要MCP Preflight帐户。
  • 购买专业版： 条纹结账
  • 激活和安装： 专业指南

MCP Preflight不做什么

  • 默认情况下，它不运行托管扫描。
  • 它不充当代理运行时或运行时网关。
  • 它不要求在默认扫描中进行实时服务器测试。
  • 它并不试图成为一个完整的AppSec套件。

本地活动

MCP Preflight可以保留一个小的本地活动日志，这样你就可以看到你扫描的频率，你是否碰到了Pro门，以及机器上是否已经安装了本地Pro令牌。

那个日志是本地的。它不包括工作区内容，MCP Preflight也不会将其上传到托管后端。

  • 禁用它 MCP_PREFLIGHT_DISABLE_ACTIVITY=1
  • 使用以下命令更改文件路径 MCP_PREFLIGHT_ACTIVITY_FILE=/path/to/activity-log.jsonl

CLI命令

如果你使用的是npm安装的CLI：

  • mcp-preflight scan /path/to/workspace
  • mcp-preflight scan /path/to/workspace --format json
  • mcp-preflight scan /path/to/workspace --no-exit-code
  • mcp-preflight --help

如果您直接使用GitHub Release捆绑包：

  • node mcp-preflight.js scan /path/to/workspace
  • node mcp-preflight.js scan /path/to/workspace --format json
  • node mcp-preflight.js scan /path/to/workspace --no-exit-code
  • node mcp-preflight.js --help

仅限Pro的CLI界面：

  • mcp-preflight license guide
  • mcp-preflight license status
  • mcp-preflight license install --from-file /path/to/license.token
  • mcp-preflight ci /path/to/workspace --policy balanced
  • mcp-preflight hooks install /path/to/repo --hook pre-push

读下一个

存储库布局

  • packages/core：共享扫描引擎
  • packages/cli：命令行入口点
  • apps/vscode-extension：VS代码集成

支持

相关 MCP