agent-guard-mcp

Name: agent-guard-mcp
Author: liminalpepe

本地服务

github.com/liminalpepe安全017 周前更新

代码仓库

关于 agent-guard-mcp

agent-guard-mcp 是供 Agent 和团队在安装或合并前检查软件供应链变更的 MCP 服务，可评估软件包、锁文件、技能清单和 CI 工作流。

主要功能

01检查 npm 和 PyPI 软件包
02扫描锁文件中的直接及传递依赖
03评估技能和插件清单
04检查 CI 工作流风险

适用场景

01安装前审查依赖项
02运行安装前检查生成的锁文件
03评估第三方技能或 MCP 插件
04合并前审查 CI 工作流变更

MCP 相关

向 MCP 客户端提供 `check_package`、`verify_lockfile`、`score_manifest` 和 `check_workflow` 四种工具。同样的检查也可通过 HTTP 服务使用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "liminalpepe-agent-guard": {
      "command": "npx",
      "args": [
        "-y",
        "@liminallablibs/agent-guard-mcp"
      ]
    }
  }
}

启动命令npx -y @liminallablibs/agent-guard-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@liminallablibs/agent-guard-mcp0.2.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
name	string	是	包名称，例如 "huggingface-cli"。
ecosystem	enum	否	npm \| pypi

详细介绍

agent-guard-mcp

一句话： 为 AI Agent 提供先验证再操作的安全保障——在安装或合并之前检查软件包、锁文件、技能清单和 CI 工作流。无需 API 密钥，无需配置。

为 Cursor/Claude 技能清单和 GitHub Actions 工作流评分——不只是 npm 依赖项。

当你……	调用
执行 `npm install foo` / Agent 建议添加新依赖项	`check_package`
审查大模型生成的锁文件	`verify_lockfile`
安装 Cursor 技能或 MCP 插件	`score_manifest`
合并涉及 `.github/workflows/*` 的 PR	`check_workflow`

在安装依赖项、合并 CI 更改，或安装第三方技能/插件之前调用这些工具，让 Agent 拒绝虚构的软件包、拼写仿冒、投毒的清单和遭入侵的 CI 操作。

提供四种 MCP 工具（也可作为普通 HTTP 服务使用）：

工具	在……之前使用	返回
`check_package`	添加单个 npm/PyPI 依赖项	OK / SUSPICIOUS / DANGER + 拼写仿冒/低质内容标记
`verify_lockfile`	执行 `npm/pip/yarn install`	扫描锁文件中的所有直接和传递依赖项
`score_manifest`	安装 Cursor/Claude 技能或 MCP/Smithery 插件	投毒特征 + 权限范围过度扩张 + 漂移评分（0–100）
`check_workflow`	合并涉及 CI 的 PR	标记可变的操作版本固定、遭入侵的操作、curl\|bash、pwn-requests、机密信息暴露

为什么

AI Agent 经常会虚构软件包名称（slopsquatting），轻信大模型生成的锁文件，安装未经审核的技能包，并将 CI 操作固定到可变标签。每一种都是现实存在的供应链攻击途径。此服务让 Agent 在采取行动之前，能够低成本地确认“这是否安全”。

安装（MCP 客户端）

{
  "mcpServers": {
    "agent-guard": { "command": "npx", "args": ["-y", "@liminallablibs/[email protected]"] }
  }
}

Agent 规则（粘贴到 Cursor Rules / CLAUDE.md）

在安装任何 npm/PyPI 软件包、根据锁文件执行安装、安装第三方技能/MCP 插件，或合并 CI 工作流更改之前，调用 agent-guard MCP 工具（check_package、verify_lockfile、score_manifest、check_workflow）。如果判定结果为 SUSPICIOUS、REVIEW 或 BLOCK/DANGER，请停止操作并向用户展示检查结果——不要继续。

快速演示

npx -y @liminallablibs/[email protected]   # MCP clients spawn this via npx
# HTTP mirror:
npm run http && curl "http://localhost:8402/check?name=reactt&ecosystem=npm"
# → DANGER — typosquat of "react"

也可直接运行：

npm install
node src/mcp-server.mjs        # stdio MCP server
npm run http                   # optional HTTP mirror on :8402

HTTP 端点（与 MCP 工具对应）

GET /check?name=<pkg>&ecosystem=<npm|pypi>
POST /check-lockfile {lockfile_content, format} — 格式 ∈ package-lock.json | yarn.lock | pnpm-lock.yaml | poetry.lock | requirements.txt
POST /score-manifest {manifest_type, manifest_content}
POST /check-workflow {workflow_content}