/ 目录 / 演练场 / Cisco MCP Scanner
● 官方 cisco-ai-defense ⚡ 即开即用

Cisco MCP Scanner

作者 cisco-ai-defense · cisco-ai-defense/mcp-scanner

Run a battery of prompt-injection, tool-shadowing, and exfiltration tests against any MCP server before you trust it in production.

Cisco's scanner enumerates an MCP server's tools, descriptions, and prompts, then probes them with known attack templates: indirect injection in returned data, tool-name shadowing, suspicious schema fields, exfil-via-error, and more. You get a Markdown/JSON report you can attach to a PR.

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "cisco-mcp-scanner": {
      "command": "uvx",
      "args": [
        "mcp-scanner",
        "--server",
        "stdio:npx -y <target>"
      ],
      "_doc": "Run against any MCP server config; produces a security report."
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "cisco-mcp-scanner": {
      "command": "uvx",
      "args": [
        "mcp-scanner",
        "--server",
        "stdio:npx -y <target>"
      ],
      "_doc": "Run against any MCP server config; produces a security report."
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "cisco-mcp-scanner": {
      "command": "uvx",
      "args": [
        "mcp-scanner",
        "--server",
        "stdio:npx -y <target>"
      ],
      "_doc": "Run against any MCP server config; produces a security report."
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "cisco-mcp-scanner": {
      "command": "uvx",
      "args": [
        "mcp-scanner",
        "--server",
        "stdio:npx -y <target>"
      ],
      "_doc": "Run against any MCP server config; produces a security report."
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "cisco-mcp-scanner",
      "command": "uvx",
      "args": [
        "mcp-scanner",
        "--server",
        "stdio:npx -y <target>"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "cisco-mcp-scanner": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-scanner",
          "--server",
          "stdio:npx -y <target>"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add cisco-mcp-scanner -- uvx mcp-scanner --server 'stdio:npx -y <target>'

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Cisco MCP Scanner

Audit a third-party MCP before adopting it

👤 Developers ⏱ ~15 min intermediate

何时使用: A teammate wants to install a community MCP and you want a security signal first.

步骤
  1. Install scanner
    uvx mcp-scanner --help✓ 已复制
    → Scanner runs
  2. Scan
    mcp-scanner --server "stdio:npx -y the-mcp" --output report.md✓ 已复制
    → Report written
  3. Review
    Open report.md; triage findings by severity.✓ 已复制
    → Adoption decision documented

结果: Documented security review before merging the MCP into your config.

Gate MCP changes in CI

👤 Developers ⏱ ~15 min intermediate

何时使用: You ship an internal MCP and want a baseline check on every PR.

步骤
  1. Add CI step
    Run mcp-scanner against the built server; fail on HIGH findings.✓ 已复制
    → PR fails on regressions
  2. Fix or accept
    Each finding gets fixed or annotated with a risk acceptance.✓ 已复制
    → Clean baseline

结果: No new prompt-injection surface ships unreviewed.

组合

与其他 MCP 搭配,撬动十倍杠杆

cisco-mcp-scanner + github

Run on every PR via Actions; comment findings on the PR

Combine cisco-mcp-scanner with github: Run on every PR via Actions; comment findings on the PR✓ 已复制
cisco-mcp-scanner + sentry

Pipe scanner findings as Sentry alerts on main branch

Combine cisco-mcp-scanner with sentry: Pipe scanner findings as Sentry alerts on main branch✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
scanner CLI (see docs) Not exposed as MCP tools — this is a scanner, not a server 1 call

成本与限制

运行它的成本

API 配额
N/A
每次调用 Token 数
Local — uses the target MCP only
费用
Free OSS
提示
Run scans in a sandboxed network so probes can't exfil real data

安全

权限、密钥、影响范围

凭据存储: No credentials by itself
数据出站: Whatever the target MCP egresses
切勿授予: point at a production MCP with real credentials — use a staging instance

故障排查

常见错误与修复

Scanner times out on a slow MCP

Increase --timeout; check the server actually starts under stdio

False positives on benign tools

Use --baseline to mark them; future runs ignore

替代方案

Cisco MCP Scanner 对比其他方案

替代方案何时用它替代权衡
Manual reviewSingle-author trusted MCPMisses subtle injection patterns

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills