Gadriel AI Security Harness

Name: Gadriel AI Security Harness
Author: Gadriel-ai

本地服务

gadriel.ai安全01 天前更新

代码仓库访问官网

关于 Gadriel AI Security Harness

Gadriel AI Security Harness 扫描 GitHub Copilot 编写的代码，检查常规及 AI 特有的安全风险。扫描在本机运行，并通过 MCP 工具、仓库指南、提示词和审查 Agent 为 Copilot 提供支持。

主要功能

01本地 SAST 与密钥扫描
02依赖、容器和配置检查
03检测提示词注入和 OWASP LLM 风险
04用于发现项和修复的 MCP 工具
05Copilot 仓库指南与审查 Agent

适用场景

01扫描由 Copilot 编写的代码仓库
02检查特定文件的发现项
03让 Copilot 修复安全问题

MCP 相关

MCP 服务向 Copilot 提供扫描和发现项管理工具，包括文件与缓冲区验证、发现项查询及修复。扫描在本机运行，需通过 MCP 工具和提示词触发，不会在每次编辑时自动执行。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "gadriel-ai-gadriel": {
      "command": "npx",
      "args": [
        "-y",
        "gadriel"
      ],
      "env": {
        "GADRIEL_NO_ANONYMOUS_AUTH": "<GADRIEL_NO_ANONYMOUS_AUTH>"
      }
    }
  }
}

启动命令npx -y gadriel

需要配置的环境变量

GADRIEL_NO_ANONYMOUS_AUTH密钥Set to 1 to skip anonymous device registration with app.gadriel.ai.

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

安装包

npmgadriel1.7.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Gadriel — GitHub Copilot 的 AI 安全防护套件

扫描 Copilot 编写的代码，涵盖 SAST、机密信息、依赖项（SCA/SBOM）、容器和配置，以及提示词注入和 OWASP LLM Top 10 等 AI 特有风险 —— 包含 3,000 多条规则，在你的设备上扫描。Gadriel 通过 MCP 服务、仓库说明、提示词和审查 Agent 接入 Copilot。

它是 Gadriel AI 安全防护套件的一部分，也支持 VS Code、 Claude Code、 Codex 和 Cursor。

获取

最简单的方式 — 安装 VS Code 扩展。 从 Marketplace 安装 Gadriel AI Security Harness。它会自动为 Copilot 注册 gadriel MCP 服务，并添加 Gadriel: Scan Repository 命令，无需编辑配置。

或者自行添加 MCP 服务。 此服务已发布到 GitHub MCP Registry，名称为 io.github.Gadriel-ai/gadriel，因此会显示在 VS Code 的 MCP: Browse Servers 和 Copilot Chat 的 @mcp 搜索结果中 — 只需点击一下即可添加。若要将其配置到特定仓库，请将此 .vscode/mcp.json 放入项目中（需要 Node 才能使用 npx，或运行 npm install -g gadriel）：

{ "servers": { "gadriel": { "type": "stdio", "command": "npx", "args": ["-y", "[email protected]", "code", "mcp"] } } }

添加 Copilot 指引（可选）。 将 .github/ 目录复制到仓库中，让 Copilot 了解如何使用 Gadriel：

路径	内容
`.github/copilot-instructions.md`	仓库级指引，自动应用
`.github/instructions/*.instructions.md`	17 条主题规则，根据 `applyTo` 指定范围
`.github/prompts/*.prompt.md`	`/gadriel-scan`、`/gadriel-fix`、`/gadriel-status`、…
`.github/agents/*.agent.md`	8 个审查 Agent

使用

在 Copilot Chat（Agent 模式）中，直接提出请求：“对这个仓库运行 Gadriel 安全扫描并总结发现的问题”，或调用 /gadriel-scan 等提示词。 Copilot 可以直接使用 gadriel MCP 工具 — validate_file、findings_for_path、fix_finding、 validate_buffer 等。

须知

此处没有自动编辑防护。 Copilot/VS Code 不支持编辑时钩子（Cursor 和 Codex 支持），因此扫描需通过 MCP 工具和提示词按需运行，而不会在每次编辑时阻止操作。
企业版： Copilot Business/Enterprise 可通过托管 MCP 策略将 gadriel MCP 服务加入允许列表。
隐私： 代码在本地扫描，绝不会上传。首次运行时，会向 app.gadriel.ai 注册匿名设备凭据（随机设备 ID — 不包含主机名、用户名或密钥）；设置 GADRIEL_NO_ANONYMOUS_AUTH=1 可跳过此步骤。请参阅隐私政策。

维护者

注册表条目由 .github/workflows/publish-mcp.yml （GitHub OIDC — 组织命名空间只能通过 Gadriel-ai 仓库中的 CI 发布）发布或重新发布。每次发布新的 gadriel npm 版本后，请更新 server.json 和 .vscode/mcp.json 中固定的版本，然后重新运行该工作流。