mcp-audit-server

mcp-audit-server

用于 AI Agent 和 MCP 安全审计的轻量级 MCP 服务和 CLI 代理。它连接到私有审计 API，用于分析 MCP 配置、测试提示词注入防护能力、追踪数据流、扫描软件包并生成安全策略。

此软件包是一个轻量级代理。所有扫描逻辑都位于由你或你的服务提供商运营的私有后端中。

托管服务流程：

• 设置 AGENT_SECURITY_API_KEY
• 软件包将自动连接到 https://audit.leddconsulting.com

自托管或私有网络流程：

• 将 AGENT_SECURITY_BASE_URL 设置为你的 HTTPS API 源地址
• 或者为环回/私有部署设置 AGENT_SECURITY_HOST 和 AGENT_SECURITY_PORT

此软件包不包含托管后端访问权限。如需托管服务或获得许可的私有部署，请联系 Ledd Consulting。

注册表和目录

• npm 软件包：ledd-mcp-audit-server
• 官方 MCP 注册表名称：io.github.joepangallo/mcp-audit-server
• Glama 和 PulseMCP 等下游目录应从官方 MCP 注册表获取信息，因此通常无需为每个网站单独手动提交。
• Glama 作者身份认领为可选操作。认领后，你可以拥有 Glama 页面，并使用手动同步和重新扫描控件。

安装

npm install ledd-mcp-audit-server

安装软件包：ledd-mcp-audit-server 安装后的 CLI 命令：mcp-audit-server

这是应发布到 npm 并列入公开 MCP 目录的公共软件包。审计引擎本身仍为私有。

旧软件包名称 mcp-server-agent-security 已停用。升级步骤和弃用计划请参阅 MIGRATION.md。

用作 MCP 服务

将其添加到 MCP 客户端配置中（Claude Desktop、Cursor 等）：

{
  "mcpServers": {
    "mcp-audit-server": {
      "command": "npx",
      "args": ["-y", "ledd-mcp-audit-server", "--mcp"],
      "env": {
        "AGENT_SECURITY_API_KEY": "your-issued-api-key"
      }
    }
  }
}

对于自托管后端，请将 AGENT_SECURITY_BASE_URL 添加到同一个 env 代码块中。

此服务通过 stdio 提供 10 个工具：

工具	描述
audit_mcp_config	对 MCP 配置 JSON 进行静态分析，检查权限、身份验证、传输和启动风险
audit_mcp_server	通过 stdio 对正在运行的 MCP 服务进行主动探测（需要 AGENT_SECURITY_ADMIN_MODE=1）
audit_agent_trust	对工具权限、执行来源、机密信息暴露控制、策略偏差和部署信任评分进行信任审计
audit_prompt_injection	使用包含 30 多种载荷的注入目录测试系统提示词
audit_agent_dataflow	追踪 PII 和机密信息在 Agent 工具管道中的暴露情况
scan_mcp_package	扫描 npm MCP 软件包中的依赖漏洞和危险模式
generate_report	合并多个审计结果，生成包含执行摘要的综合报告
fix_mcp_config	自动修复配置问题：移除不安全标志、升级传输方式、隐藏机密信息
harden_system_prompt	向系统提示词追加可抵御注入的防护规则
generate_policy	根据 MCP 配置生成可强制执行的 JSON 安全策略

用作 CLI

CLI 会将命令转发到私有审计 API。

# Hosted quick start
export AGENT_SECURITY_API_KEY=your-issued-api-key

# Audit an MCP configuration file
mcp-audit-server scan-config ./claude_desktop_config.json

# Probe a live MCP server (requires AGENT_SECURITY_ADMIN_MODE=1)
mcp-audit-server scan-server npx -y @modelcontextprotocol/server-filesystem /tmp

# Audit trust posture and policy drift for an agent/MCP deployment
mcp-audit-server scan-trust ./claude_desktop_config.json ./claimed-policy.json

# Scan an npm package for vulnerabilities
mcp-audit-server scan-package @modelcontextprotocol/server-shell

# Test a system prompt for injection vulnerabilities
mcp-audit-server scan-injection ./system-prompt.txt

# Trace data flows through an MCP config
mcp-audit-server scan-dataflow ./claude_desktop_config.json

# Auto-fix security issues in an MCP config
mcp-audit-server fix-config ./claude_desktop_config.json

# Harden a system prompt against injection
mcp-audit-server harden-prompt ./system-prompt.txt

# Generate a security policy from an MCP config
mcp-audit-server generate-policy ./claude_desktop_config.json

# Retrieve a previous audit report
mcp-audit-server report <audit-id>

# Output raw JSON instead of formatted tables
mcp-audit-server scan-config ./config.json --json

# Start in MCP stdio server mode
mcp-audit-server --mcp

对于自托管后端，还需设置 AGENT_SECURITY_BASE_URL=https://your-audit-host。

环境变量

变量	默认值	描述
AGENT_SECURITY_BASE_URL	（无）	完整的审计 API 源地址，例如 https://audit.example.com
AGENT_SECURITY_HOST	127.0.0.1	自托管/私有网络审计 API 主机
AGENT_SECURITY_PORT	3091	自托管/私有网络审计 API 端口
AGENT_SECURITY_API_KEY	（无）	用于身份验证访问的 API 密钥。如果设置此项但未覆盖端点，软件包将使用 https://audit.leddconsulting.com
AGENT_SECURITY_REQUEST_TIMEOUT_MS	15000	CLI 和 MCP 代理请求的超时时间
AGENT_SECURITY_ADMIN_MODE	（无）	设置为 1 以启用主动服务探测

检测内容

• 工具欺骗 —— 工具名称重复、命名空间冲突（CWE-290）
• 恶意接管 —— 未固定的软件包、版本漂移（CWE-829）
• 提示词注入 —— 直接覆盖、指令劫持、角色扮演逃逸、分隔符注入、编码绕过、多语言注入
• 权限提升 —— 权限过高的工具、未使用允许列表的 shell 执行、不受限制的文件系统访问
• 数据外泄 —— 通过工具管道泄露 PII、出站网络路径
• 传输不安全 —— 缺少 TLS、配置中包含明文凭据
• 缺少身份验证 —— 未经身份验证的 MCP 服务、未要求提供 API 密钥
• Shell 注入 —— 通过工具配置执行任意命令
• 路径遍历 —— 工具参数中的文件系统范围不受限制
• SQL 注入 —— 工具定义中存在原始 SQL 模式
• 速率限制 —— 暴露的工具缺少请求限流
• 软件包漏洞 —— npm MCP 软件包依赖项中存在已知 CVE
• 凭据泄露 —— 内联密钥、缺少轮换策略
• Agent 信任偏移 —— 声称安全的策略与已配置的工具、网络态势或观察到的操作日志不匹配
• 来源信息薄弱 —— 缺少对高风险 Agent 操作的行为／证据记录

要求

• Node.js >= 20
• 可访问私有审计 API。设置 AGENT_SECURITY_API_KEY 时，默认托管服务为 https://audit.leddconsulting.com。对于其他托管 HTTPS 部署，请使用 AGENT_SECURITY_BASE_URL；对于本地／专用网络部署，请使用 AGENT_SECURITY_HOST 和 AGENT_SECURITY_PORT。

来源证明

2.0.0 至 2.1.0 版本发布时，发布工作流尚未建立，因此不包含来源证明。3.0.1 及更高版本通过启用了来源证明的可信发布工作流发布。

。github/workflows/publish.yml 中的发布工作流通过 npm 可信发布（OIDC——无需长期令牌），使用 npm 来源证明（npm publish --provenance）发布 v* 标签。使用 npm audit signatures 和 npmjs.com 上的来源证明徽章验证发布。

许可证

MIT

---

由 Ledd Consulting 构建