ActionGuard Protocol Inspector Agent

io.github.lsendel由 GitHub 帳號 lsendel 發布v1.0.0更新於 Nov 4, 2026

Diff and poisoning detection for MCP servers: catch schema drift and prompt poisoning.

已驗證Streamable HTTP可網頁執行開發者工具安全與監控

概覽

AI 產生的概覽

遠端 MCP 伺服器,用於稽核 MCP 伺服器與 AI 代理端點的可靠性、安全性與 schema 漂移,並依固定雜湊驗證工具。

可以做什麼
  • 對 MCP 或代理端點執行五階段即時可靠性、安全與 schema 稽核,回傳分級評分卡
  • 將 MCP 伺服器的工具 schema 與描述和固定的雙雜湊基準比對,偵測漂移或遭投毒的描述
適用情境
適合維護或依賴 MCP 伺服器的人,在代理執行工具前發現工具 schema 的無聲變更或遭竄改的工具描述,例如作為發佈前或 CI 式檢查。
執行需求
透過 streamable HTTP 連線到 actionguard.ai 的遠端端點;未宣告驗證、環境變數或標頭。目標 MCP 或代理端點需能被該服務存取,漂移檢查還需提供固定雜湊。
安裝前請注意
此服務會從自身基礎設施探測第三方端點,目標 URL 會提供給第三方。漂移檢查依賴你自行提供並維護的固定雜湊。README 另提到付費 API 金鑰、代理閘道與監控,這些與這兩個工具是分開的。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ActionGuard Protocol Inspector Agent,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.lsendel%2Factionguard/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "actionguard-protocol-inspector-agent": {
      "type": "http",
      "url": "https://actionguard.ai/mcp"
    }
  }
}

README

ActionGuard.ai

[ActionGuard Verified] [Glama Quality Score] [Smithery] [CI Tests] [License: MIT] [Edge: Cloudflare]

Drift and poisoning detection for MCP servers.
"SSL Labs for MCP servers. Know when your tools change, not just when they go down."
Diff detection for MCP tools: catch silent schema drift and poisoned tool descriptions before your autonomous agents run them.


Live Production Services


Quickstart

1. GitHub Actions CI Gate

Block breaking changes and unannounced schema mutations before they hit production:

yaml
name: CIon: [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. Zero-Trust Runtime Gateway Proxy ("Cloudflare for MCP")

Route agent tool calls through ActionGuard's edge firewall to terminate drifted tools with HTTP 423 Locked:

json
{  "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. Embed Live Status Badges in Your Repository

Show real-time verification and protocol compliance on your MCP server's GitHub repository.

Markdown (Native SVG)
markdown
[![ActionGuard Verified](https://actionguard.ai/badge/<your-domain-or-slug>.svg)](https://actionguard.ai/servers/<your-domain-or-slug>)
Shields.io Endpoint
markdown
[![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>)
  • Domain Verified Badge: Gold (#f59e0b) badge ⭐ A • Domain Owner displayed when domain ownership is claimed via DNS TXT or .well-known/actionguard-verification.
  • Reliability Grades: Dynamic color coding based on cryptographic dual-hash baseline and 5-stage protocol inspection (A+, A, B, C, D, F).
Claude Desktop & Cursor (claude_desktop_config.json)
json
{  "mcpServers": {    "github": {      "url": "https://actionguard.ai/v1/proxy?target=https://github.mcp.modelcontextprotocol.io/mcp&pin=81d36f5215b689d6f100cfe77096fbe8d113c304c0dd8374d69a84678fb69415"    }  }}
Python (LangChain / CrewAI / httpx)
python
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 poisonedclient = httpx.Client(base_url=f"{GATEWAY}?target={TARGET}&pin={PIN}")

3. Run as an MCP Server (Claude Desktop, Cursor, Glama)

You can run ActionGuard natively as a tool inside any MCP client:

Stdio Mode (Claude Desktop claude_desktop_config.json)
json
{  "mcpServers": {    "actionguard": {      "command": "npx",      "args": ["-y", "@actionguard/cli", "mcp"]    }  }}
Streamable HTTP Mode
json
{  "mcpServers": {    "actionguard": {      "url": "https://actionguard.ai/mcp"    }  }}

4. CLI Quick Run

bash
# Run 5-stage live protocol audit against any MCP or A2A endpointnpx @actionguard/cli inspect https://api.myservice.com/mcp
# Compile single actionguard.json to MCP server.json, A2A agent-card.json, and DNS-AID recordsnpx @actionguard/cli compile ./actionguard.json
# Local CI checknpx @actionguard/cli check https://api.myservice.com/mcp --pin <hash>

Core Product Pillars

  1. The 5-Stage Live Inspector ("SSL Labs for Agents"): Zero-signup diagnostic tool running live edge probes against MCP and A2A endpoints, returning an A+ to F scorecard and instant copy-paste fixes.
  2. Dual-Hash Integrity Engine: Distinct cryptographic fingerprints for JSON Schemas (schema_sha256) versus tool descriptions (descriptions_sha256) to catch silent prompt mutations.
  3. Enterprise Dependency Watchlist: Automated 15-minute edge monitoring with instant multi-channel alerts (Slack Block Kit, Discord Embeds, Email via Resend, and signed Webhooks).
  4. Self-Serve Domain Proof (DNS-AID): Cryptographic domain verification via DNS TXT records or well-known challenge files to earn the Gold "⭐ Domain Verified" badge.
  5. Zero-Trust Runtime Firewall: Low-latency proxy (<15ms) that blocks execution before poisoned or drifted payloads reach your LLM.

Infrastructure Architecture

Built entirely on the Cloudflare edge stack for global sub-50ms latency:

  • Cloudflare Workers: Edge probing engine, public API, zero-trust proxy, and dynamic SVG badges.
  • Cloudflare D1: High-performance relational edge database for accounts, catalog, subscriptions, and API keys.
  • Cloudflare R2: Content-addressed, immutable storage for historical snapshot payloads, raw schemas, and audit logs.
  • Continuous Monitoring: 15-minute cron trigger with automatic drift detection and Resend email / Slack dispatch.

Monorepo Packages

text
├── 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

Documentation


License

MIT © ActionGuard.ai

來源:README.md,提交 7a2b41b

工具

2

actionguard_inspect

Run a 5-stage continuous reliability, security, and schema audit of an MCP server or AI agent endpoint.

輸入參數url必填

actionguard_check_drift

Verify whether an MCP server's tools schema or descriptions have drifted from a pinned Dual-Hash.

輸入參數url必填pinnedSchemaHash必填

版本歷史

1
  1. v1.0.0最新Oct 21, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。