MA

mvikmanners/aw1-circuit-breaker

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

1 stars 0 forks 质量 74 趋势 22Apache-2.0

适用于自主AI代理、工具调度流水线和MCP服务器的确定性小于0.2毫秒的AST安全断路器。

概览

阅读独立源代码层面的拆解:aw1-breaker 2.0.0在工具调用前检查了哪些内容。 aw1-breaker 是一款零依赖的 Python 安全断路器,利用抽象语法树(AST)反编译、每演员滚动速度监控器和加密签名的 HMAC 执行令牌,拦截亚毫秒执行循环中的自主 AI 代理工具调用。 适用于自主AI代理、工具调度流水线和MCP服务器的确定性小于0.2毫秒的AST安全断路器。 现在就在你的端子里测试断路器,但不要安装任何东西: 确定性AST解构和运行时断路器防止流氓壳逃逸、动态评估( )以及自主大型语言模型工具调用中的隐蔽横向套接字退出。 AW-1在代码到达Python运行时执行帧之前,在抽象语法树(AST)层面以确定性方式运行。

概述(AI 翻译)

适用于自主AI代理、工具调度流水线和MCP服务器的确定性小于0.2毫秒的AST安全断路器。


⚡ 10秒试驾(零安装)

现在就在你的端子里测试断路器,但不要安装任何东西:

或者验证一个任意的片段:


AW-1 断路器

确定性AST解构和运行时断路器防止流氓壳逃逸、动态评估( )以及自主大型语言模型工具调用中的隐蔽横向套接字退出。

安装

运行服务器

直接用Python运行:

或者通过UVX传输:

MCP 客户端配置

利用拦截的行动

AW-1在代码到达Python运行时执行帧之前,在抽象语法树(AST)层面实现确定性工作。基于提示的概率保护栏在编码混淆下失效;AST检查保证确定性执行。

拦截矩阵

攻击向量 攻击者策略 LLM 护栏结果 AW-1 AST 断路器
动态执行eval(compile(...)) 规避语义滤波 绊倒(RESTRICTED_INVOCATION)
壳逃脱 '子进程。Popen([‘bash’, …

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Install with HOL Guard, which checks the HOL listing and asks before each runtime:

hol-guard plugin install mvikmanners/aw1-circuit-breaker --apply

Get HOL Guard with pipx install hol-guard or uv tool install hol-guard.

AW-1 Circuit Breaker

Deterministic sub-0.2ms AST security circuit breaker for autonomous AI agents, tool dispatch pipelines, and MCP servers.


⚡ 10-Second Test Drive (Zero-Install)

Test the circuit breaker live in your terminal right now without installing anything:

uvx aw1-circuit-breaker --demo

Or verify an arbitrary snippet:

uvx aw1-circuit-breaker verify "subprocess.run(['rm', '-rf', '/'])"

AW-1 Circuit Breaker

Deterministic AST deconstruction and runtime circuit breaker preventing rogue shell escapes, dynamic eval(), and covert lateral socket egress in autonomous LLM tool calls.

Installation

pip install -r requirements.txt

Running the Server

Run directly with Python:

python mcp_server.py

Or via uvx:

uvx mcp_server.py

MCP Client Configuration

{
  "mcpServers": {
    "aw1-circuit-breaker": {
      "command": "python",
      "args": ["mcp_server.py"]
    }
  }
}

Exploit Interception in Action

在 GitHub 查看完整 README

安装

uvx aw1-circuit-breaker --demo
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "aw1-circuit-breaker": { "command": "python", "args": ["mcp_server.py"] } } }