AgentAvow

AgentAvow（前身为 AgentGraph）是一个面向 AI 智能体工具生态的安全评级与证明服务，核心目标是回答“这个工具对我的智能体来说是否安全可连接”。它适用于任意工具、MCP 服务器、npm 或 PyPI 软件包以及 OpenClaw 技能，也支持输入可解析到上述对象的钱包地址。

主要能力

• 三档结论与原因：每次扫描首先给出“可安全连接（Safe to connect）”“连接前需审查（Review before you connect）”“请勿连接（Do not connect）”之一，并说明原因。
• 双评分体系：在结论之后给出 0–100 的信任分（含信任层级作为细节）以及基于真实使用情况（下载量、星标、安装量）构建的采用度评分。信任分由扫描发现项计算得出，并附带五个独立维度的子分：密钥卫生、代码安全、数据处理、文件系统访问、依赖健康。每个发现项都带有严重级别，并指向具体代码行或清单条目。
• 签名可验证证明：每个结果附带基于规范化裁决（RFC 8785 JCS）的 JWS 证明（EdDSA / Ed25519，RFC 7515）。任何人都可以对照 agentgraph.co/.well-known/jwks.json 上的公开 JWKS 离线重算并验证。
• 信任层级与建议限制：每个信任分映射到一个信任层级（从 verified 到 blocked），并给出建议的执行姿态（每分钟请求数、token 预算、确认提示），便于网关或智能体框架自动执行。
• 信任徽章：一行 shields.io 兼容的 SVG 徽章，可放入 README，展示仓库当前结论与签名信任分，并链接到完整可验证报告。徽章以开放 CORS 提供，并从每小时扫描缓存刷新。
• 监控与变更告警：可监控某个工具，AgentAvow 会重新扫描，并在其分数下降或签名工具定义发生变化（tool_manifest_digest 漂移）时发出告警，帮助发现“拉地毯”式变更。
• 认领仓库：通过添加 GitHub topic 证明对公开仓库的所有权（不存储令牌），或使用临时提供的 GitHub 令牌运行私有扫描（不持久化，也不加入公开目录）。
• 公开信任目录：可分页、可筛选的扫描目录（启动语料库加社区按需扫描），可按表面、严重级别和分数浏览。

使用方式

• 免费匿名扫描：无需账号、无需安装，将 AgentAvow 指向任意 GitHub 仓库、MCP 服务器、npm 或 PyPI 包、OpenClaw 技能或钱包地址即可获得三档结论之一及原因。结果缓存 1 小时，使用 ?force=true 可强制重新扫描。
• 从 Claude Code 使用：提供 MCP 服务器（见 sdk/mcp-server/）。推荐的 Claude Code 插件已列入 Anthropic 插件目录，捆绑 MCP 连接器、/scan 命令、在 Claude 添加或安装前扫描服务器或包的技能、SessionStart 钩子（首次见到已配置的 MCP 服务器时检查，仅警告、失败开放）以及 PreToolUse 门禁（每次 MCP 工具调用前检查文件中的结果：对读取到“请勿连接”的服务器拒绝调用，对定义自检查后发生变化的工具先询问）。也可直接从仓库安装插件，然后尝试 /scan npm chalk。该钩子会跳过 localhost 或私有网络上的服务器，隐去路径疑似携带密钥的 URL，并在 URL 离开本机前剥离凭据和查询字符串。
• 仅连接器：在 Claude（网页或桌面）中从连接器目录添加 AgentAvow；在 Claude Code 中不使用插件时也可手动配置。
• 从编辑器连接：远程 MCP 服务器位于 https://agentavow.com/mcp（Streamable HTTP，无认证，只读），无需安装。提供 Cursor 和 VS Code 的一键安装链接，也可手动添加到 ~/.cursor/mcp.json、项目级 .cursor/mcp.json 或 .vscode/mcp.json。本地 stdio 服务器可通过 pip install agentavow-trust 安装。
• CI 门禁：GitHub Action、GitLab CI 组件、Bitbucket Pipe、Azure Pipelines 模板或本地 CLI 可在结论为“请勿连接”时使构建失败（fail_on: do_not_connect）。npm 包 agentavow-trust 为 Vercel AI SDK、Flue、Claude Agent SDK 和 OpenAI Agents SDK 添加逐调用门禁；Python 的 LangChain、Google ADK、Claude Agent SDK 和 OpenAI Agents SDK 门禁位于 src/bridges/。面向策略引擎和网关，integrations/opa/ 提供 Open Policy Agent 策略（含 Envoy ext_authz 示例），integrations/litellm/ 提供 LiteLLM MCP 网关的护栏。demos/rugpull/ 中有可运行的拉地毯演示。

部署与开发

• 环境要求：Python 3.11+（生产使用 3.12），可选 Docker 与 Docker Compose。
• Docker Compose（推荐）：后端 API 位于 http://localhost:8000，前端位于 http://localhost（端口 80），PostgreSQL 位于 localhost:5432，Redis 位于 localhost:6379，数据库迁移在启动时自动运行。
• 本地开发：后端运行于 http://localhost:8000，前端运行于 http://localhost:5173（将 API 请求代理到后端）。
• 配置：必需项在 .env，可选项在 .env，密钥在 .env.secrets，前端配置在 web/.env。
• API：公开扫描 API 无需认证。所有应用端点使用 /api/v1 前缀；交互式 API 文档位于 /api/v1/docs（Swagger）和 /api/v1/redoc（/docs 为产品文档）。GET /health（无前缀）检查数据库与 Redis 连通性。
• 代码规范：使用 from future import annotations 处理联合类型；ruff 检查（E、F、I、N、W、UP 规则），行宽 100；所有 Python 文件必须能通过 AST 解析；新增或变更代码需要单元测试。
• 安全特性：可配置来源的 CORS、速率限制（读、写、认证分别限制）、安全响应头（HSTS、X-Frame-Options、X-Content-Type-Options 等）、请求 ID 关联追踪、带 HTML 清理的内容过滤、HMAC-SHA256 webhook 签名、bcrypt 密码哈希、登出时 JWT 令牌黑名单、敏感操作审计轨迹。

架构与限制 AgentAvow 是一个分层扫描与证明流水线：扫描产生证据，证据被评分并规范化，裁决被签名成任何人都可离线重算和验证的证明。监控形成闭环：后台重新扫描任务将每个被监控工具的新分数和签名定义摘要与上次比较，任一变化即触发 HMAC 签名的 webhook 告警。 该软件为专有软件，保留所有权利。关于具体收费、价格、平台覆盖范围或效果等未在资料中提供的信息，暂未提供。