ActionGuard Protocol Inspector Agent

ActionGuard.ai

检测 MCP 服务的漂移和投毒。
“MCP 服务的 SSL Labs。了解工具何时发生变化，而不只是何时宕机。”
MCP 工具差异检测：在自主 Agent 运行工具之前，发现隐蔽的架构漂移和被投毒的工具描述。

---

在线生产服务

• 🌐 Web 检查器与诊断引擎： https://actionguard.ai/
• 📊 公开可靠性指数： https://actionguard.ai/index
• 🎮 交互式漂移与提示词投毒模拟器： https://actionguard.ai/playground
• ⭐ 自助式域名所有权门户： https://actionguard.ai/verify
• 💳 开发者 API 密钥与定价： https://actionguard.ai/pricing
• 📖 协议指南与规范： https://actionguard.ai/docs/mcp-schema-drift

---

快速开始

1. GitHub Actions CI 门禁

在破坏性更改和未经通知的架构变更进入生产环境之前将其拦截：

name: CI
on: [pull_request]

jobs:
  verify-agent-tools:
    runs-on: ubuntu-latest
    steps:
      - name: Verify Upstream MCP Tools
        uses: lsendel/actionguard@v1
        with:
          target_url: 'https://github.mcp.modelcontextprotocol.io/mcp'
          pinned_hash: '81d36f5215b689d6f100cfe77096fbe8d113c304c0dd8374d69a84678fb69415'

---

2. 零信任运行时网关代理（“MCP 的 Cloudflare”）

通过 ActionGuard 的边缘防火墙转发 Agent 工具调用，并以 HTTP 423 Locked 终止发生漂移的工具：

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-weather",
        "--proxy",
        "https://actionguard.ai/proxy/v1?target=https%3A%2F%2Fapi.weather.com%2Fmcp&pin=a1b2c3d4..."
      ]
    }
  }
}

---

3. 在代码库中嵌入实时状态徽章

在 MCP 服务的 GitHub 代码库中显示实时验证状态和协议合规性。

Markdown（原生 SVG）

[![ActionGuard Verified](https://actionguard.ai/badge/<your-domain-or-slug>.svg)](https://actionguard.ai/servers/<your-domain-or-slug>)

Shields.io 端点

[![ActionGuard Verified](https://img.shields.io/endpoint?url=https%3A%2F%2Factionguard.ai%2Fbadge%2F<your-domain-or-slug>.json)](https://actionguard.ai/servers/<your-domain-or-slug>)

• 域名已验证徽章： 通过 DNS TXT 或 .well-known/actionguard-verification 声明域名所有权后，显示金色（#f59e0b）徽章 ⭐ A • Domain Owner。
• 可靠性等级： 根据加密双哈希基线和 5 阶段协议检查动态进行颜色编码（A+、A、B、C、D、F）。

Claude Desktop 与 Cursor（claude_desktop_config.json）

{
  "mcpServers": {
    "github": {
      "url": "https://actionguard.ai/v1/proxy?target=https://github.mcp.modelcontextprotocol.io/mcp&pin=81d36f5215b689d6f100cfe77096fbe8d113c304c0dd8374d69a84678fb69415"
    }
  }
}

Python（LangChain / CrewAI / httpx）

import httpx

GATEWAY = "https://actionguard.ai/v1/proxy"
TARGET = "https://github.mcp.modelcontextprotocol.io/mcp"
PIN = "81d36f5215b689d6f100cfe77096fbe8d113c304c0dd8374d69a84678fb69415"

# Requests fail with 423 Locked if upstream schema drifts or tool is poisoned
client = httpx.Client(base_url=f"{GATEWAY}?target={TARGET}&pin={PIN}")

---

3. 作为 MCP 服务运行（Claude Desktop、Cursor、Glama）

你可以在任何 MCP 客户端中将 ActionGuard 原生作为工具运行：

Stdio 模式（Claude Desktop claude_desktop_config.json）

{
  "mcpServers": {
    "actionguard": {
      "command": "npx",
      "args": ["-y", "@actionguard/cli", "mcp"]
    }
  }
}

Streamable HTTP 模式

{
  "mcpServers": {
    "actionguard": {
      "url": "https://actionguard.ai/mcp"
    }
  }
}

---

4. CLI 快速运行

# Run 5-stage live protocol audit against any MCP or A2A endpoint
npx @actionguard/cli inspect https://api.myservice.com/mcp

# Compile single actionguard.json to MCP server.json, A2A agent-card.json, and DNS-AID records
npx @actionguard/cli compile ./actionguard.json

# Local CI check
npx @actionguard/cli check https://api.myservice.com/mcp --pin <hash>

---

核心产品支柱

1. 5 阶段实时检查器（“Agent 的 SSL Labs”）： 无需注册的诊断工具，可对 MCP 和 A2A 端点进行实时边缘探测，返回 A+ 到 F 的评分卡以及可立即复制粘贴的修复方案。
2. 双哈希完整性引擎： 为 JSON Schema（schema_sha256）和工具描述（descriptions_sha256）分别生成不同的加密指纹，以发现隐蔽的提示词变更。
3. 企业依赖监控列表： 每 15 分钟自动进行边缘监控，并即时发送多渠道提醒（Slack Block Kit、Discord Embeds、通过 Resend 发送的 Email，以及经过签名的 Webhook）。
4. 自助式域名证明（DNS-AID）： 通过 DNS TXT 记录或 well-known 挑战文件进行加密域名验证，以获得金色“⭐ Domain Verified”徽章。
5. 零信任运行时防火墙： 低延迟代理（<15ms），可在遭到投毒或发生漂移的负载到达你的大模型之前阻止执行。

---

基础设施架构

完全基于 Cloudflare 边缘网络栈构建，实现全球范围内低于 50 ms 的延迟：

• **Cloudflare Workers：**边缘探测引擎、公共 API、零信任代理和动态 SVG 徽章。
• **Cloudflare D1：**高性能关系型边缘数据库，用于存储账户、目录、订阅和 API 密钥。
• **Cloudflare R2：**内容寻址的不可变存储，用于保存历史快照负载、原始架构和审计日志。
• **持续监控：**每 15 分钟触发一次 Cron，并自动检测偏差，通过 Resend 电子邮件 / Slack 分发通知。

---

Monorepo 包

├── packages/
│   ├── core/         # @actionguard/core — Dual-hash, linter, compiler, and probes
│   └── cli/          # @actionguard/cli — actionguard command line tool
└── apps/
    └── worker/       # Cloudflare Worker — Web Inspector, API, proxy, and D1/R2 storage

---

文档

• 产品需求文档（PRD）
• 协议规范与映射
• 系统架构与数据模型
• 分步实施计划
• Hacker News Show HN 发布帖
• Product Hunt 与 Twitter 发布工具包

---

许可证

MIT © ActionGuard.ai