agent-env-audit

AGENT AUDIT

权限边界 · 数据去向 · 密钥卫生——AI Agent 环境的一键体检

agent-audit 是开源的本地 AI Agent 环境安全审计 CLI：7 项只读检查覆盖供应链投毒、明文密钥、端口暴露、git 泄漏、依赖漏洞与 MCP server 攻击面。判定标准对照 OWASP / NSA CSI / MCP 官方安全指南，全程只读、零运行时依赖、Windows 优先。

🛒 GitHub Marketplace · English · 📖 MCP 审计白皮书 · 🏆 OpenSSF 证据清单 · MIT

_{▲ 7 项检查逐条输出 · 退出码可直接作 CI 门禁（本片为示例数据）}

🌐 English

agent-audit is a zero-dependency, read-only CLI that audits your local AI agent environment in one shot: supply-chain poisoning (market-installed skills), plaintext secrets & credential file permissions, port exposure, git-tracked secrets, known dependency vulnerabilities, and MCP server security (OWASP-aligned). Windows-first (icacls / netstat / tasklist are first-class citizens); works on Linux/macOS too. Also available as a GitHub Action.

🚨 为什么需要它（2026 实战背景）

• ClawHavoc 供应链投毒：800+ 恶意 skill 泛滥（2026-02 顶峰）；Snyk 审计 ClawHub 3984 技能中 13.4% 含严重安全问题，36.8% 有漏洞。市场导入 skill 拥有与用户同等的执行权限（terminal / file / web）。
• 端口暴露：OpenClaw 默认监听 0.0.0.0:18789，国家应急中心通报 85% 实例暴露公网；ComfyUI 1000+ 暴露实例被组僵尸网络挖矿。
• 窃密木马：Vidar 变种专偷 agent 配置目录（token / private key）。
• 依赖投毒：2026-03 LiteLLM / Axios / Apifox / Trivy 投毒波及多个 agent 应用。
• MCP 攻击面：MCP 已成 agent 连接工具数据的事实标准，远程 / 无鉴权 / 未知名 npm 包 MCP server 是新入口。

✨ 7 项检查

🚀 3 步快速开始

# 1. 安装（PyPI · 运行时零依赖）
pip install agent-env-audit

# 2. 一键体检（默认审计 Hermes 环境 + 当前工作区）
agent-audit

# 3. 读报告：Markdown + JSON 双输出在 ./agent-audit-reports/

# 或从源码 / 免安装
pip install git+https://github.com/mo9652962-ai/agent-audit.git
git clone https://github.com/mo9652962-ai/agent-audit.git && cd agent-audit && PYTHONPATH=src python -m agent_audit

# 只跑部分检查 + 指定判定阈值
agent-audit --checks ports,credentials --severity-threshold high

# 报告只出 JSON（CI 机读）
agent-audit --format json -o ./reports

🖥 在 CI 里用（GitHub Action）

已上架 GitHub Marketplace——PR 时自动跑 git 泄漏检查 + 依赖漏洞扫描，发现 ≥ 阈值级问题即失败：

- uses: mo9652962-ai/agent-audit-action@v1.0.2
  with:
    severity-threshold: high

详见 action/README.md。本仓库自己的 CI 每次 push 都在用它审计自己（dogfood）。

⚙️ 配置文件（可选）

# audit.toml —— 全部可省略
[paths]
skills_dirs = ["C:/Users/me/.agents/skills"]
config_dirs = ["C:/Users/me/AppData/Local/hermes"]

[ports]
watch = { 18789 = "OpenClaw 网关", 8188 = "ComfyUI" }
system_noise = [135, 445, 5040]

[endpoints]
whitelist = ["corp.internal"]

🧭 方法论依据

MCP 审计判定清单（检查 7）与以下权威指南对齐（2026-09 核对）：

• OWASP: A Practical Guide for Secure MCP Server Development
• NSA Cybersecurity Information Sheet: MCP Security（2026-06）
• MCP 官方 Security Best Practices（2026-07-28 spec）

已工具化覆盖：来源可信、无远程 MCP、鉴权字段、闲置禁用。NSA 清单中尚未工具化的项（tool poisoning / shadowing、token passthrough）见 Roadmap。

🎬 系列视频（抖音 · Agent 安全审计）

📖 文档

• MCP Server 安全审计白皮书 — 5 项 OWASP 对齐判定清单
• 系列文章：我给自己的 AI Agent 环境做了次安全审计
• CII Best Practices 答案清单 — OpenSSF badge 逐条证据对照

🗺 Roadmap

• skill-vetter 集成：skill 安装前审查
• --fix 模式：一键收紧权限 / 改监听（带确认）
• OWASP Agentic AI Top 10 完整映射
• GitHub Action：PR 时自动跑依赖 + git 泄漏检查
• MCP 检查扩展：tool poisoning / shadowing、token passthrough、MCP 配置文件权限（NSA CSI 清单）
• README 完整英文翻译

🛡 Security

发现漏洞请勿开公开 issue——走 GitHub Security Advisories 私密报告，7 天内响应。设计边界与已知限制见 SECURITY.md。

🤝 贡献

PR 欢迎，规范见 CONTRIBUTING.md（Actions SHA 固定 / 覆盖率棘轮 / 测试政策 / 密钥卫生）。

License

MIT

📌 更多：作者仓库矩阵（墨题刷题机 / 第二大脑 / 安全三部曲 / 孵化线）