MCP 接入前先查配置：用 mcpscan 看暴露面、权限和版本漂移

很多 MCP 接入事故并不发生在第一次工具调用之后，而是已经写进了宿主配置：监听地址不是 loopback、环境变量里留着明文密钥、工具权限过宽，或者通过 npx 拉取未固定版本。

ai-agentic-mcpscan 提供的是配置层面的只读检查。它的 CLI 命令是 mcpscan，可以发现本机 MCP server，读取 Claude、Cursor、Windsurf、Cline、VS Code、Zed、Continue 等宿主的配置，并检查暴露、凭证卫生、工具范围和版本固定情况；结果可输出为终端、HTML、稳定 JSON 和 SARIF 2.1.0。

我会这样做首轮验收

mcpscan inventory
mcpscan scan --root ~/project --json report.json --sarif results.sarif

先跑 inventory，因为它回答“本机到底发现了哪些 AI/MCP 资产”；再跑 scan，读取发现的配置路径、脱敏结果、check id 和退出码。首轮使用临时环境，记下上游 commit 和 Python 版本。默认静态路径离线、只读，不连接 MCP server，也不执行工具调用。

需要特别标出的两个开关：--online 会主动选择 OSV/PyPI 增强，改变网络边界；--fix 才进入本地写入路径，范围主要是删除过宽的工具权限，并为改动文件留下备份。它不会替你轮换已经泄露的密钥，也不会替你判断哪个依赖版本对业务安全。

我的发布门槛是三份证据：精确 commit 和 Python 版本、脱敏后的报告、带备份的前后对比。只看到“命令成功”不够；静态报告干净，也不能证明运行时行为、提示词注入防护或生产可用性。

这是 Doramagic 基于上游项目的独立操作解读，不是上游背书、安全认证或生产保证。手册：https://doramagic.ai/zh/projects/ai-agentic-mcpscan/manual/

标签：人工智能、安全、MCP、Python、开发工具、开源、DevOps、代码质量、软件测试