safe-agent-mcp

Name: safe-agent-mcp
Author: naoanao

本地服务

github.com/naoanao安全01 天前更新

代码仓库

关于 safe-agent-mcp

safe-agent-mcp 是面向生产环境 AI Agent 运维者的只读诊断服务。它检查 API 密钥权限描述和幂等性信号，并解释常见防护模式；不进行网络调用或写入。

主要功能

01标记权限过宽的 API 密钥
02扫描代码中的幂等性信号
03解释生产环境防护模式
04拒绝看似机密的输入

适用场景

01检查 API 密钥权限描述
02审查代码中的防重复执行保护
03了解审批与断路器模式

MCP 相关

提供 `audit_api_keys`、`check_idempotency_pattern` 和 `explain_guard_pattern` 三种只读诊断工具。不进行网络调用或写入。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "naoanao-safe-agent": {
      "command": "uvx",
      "args": [
        "safe-agent-mcp"
      ]
    }
  }
}

启动命令uvx safe-agent-mcp

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

安装包

pypisafe-agent-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 1 天前

参数	类型	必填	说明
keys	array	是

详细介绍

Safe AI Agent — 守护检查（免费 MCP 服务）

免费的只读 MCP 服务，提供三种诊断工具，适用于在生产环境中运行 AI Agent 的人员。内容提炼自 Safe AI Agent Pack——Sage 个人 Agent 和 Growl AI 营销 SaaS 使用的生产级守护模块。

不进行网络调用，不写入数据。检测到看起来像真实密钥的输入时会拒绝处理。

工具

工具	功能
`audit_api_keys`	根据 API 密钥权限的描述标记权限过大的密钥（切勿传入密钥值——看起来像机密的条目会被拒绝，不会被存储）
`check_idempotency_pattern`	扫描代码片段，检查是否包含真正能阻止重复执行的信号：幂等键、服务端存储、唯一性、短路处理、负载绑定、审批分离
`explain_guard_pattern`	解释一种生产级守护模式——它能防止的故障及其最简结构（`idempotency_key`、`approval_gate`、`outbox`、`key_inventory`、`circuit_breaker`、`signed_approval_link`）

安装与运行

git clone <this repo>
cd safe-agent-mcp
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python safe_agent_mcp.py   # stdio transport

Claude Desktop / Cursor MCP 配置：

{
  "mcpServers": {
    "safe-agent-guard-checks": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/safe_agent_mcp.py"]
    }
  }
}

测试

.venv/bin/python test_server.py   # in-memory client; calls every tool

完整套件

这款免费服务是诊断入口。生产级模块——SQLite 幂等存储、@once 装饰器、带 HMAC 签名审批链接的审批发件箱、令牌权限清单脚本、18 项回归测试，以及包含 100 个生产陷阱的目录——均收录于 Safe AI Agent Pack（$69 / 团队 $199）。

许可证

这款免费服务采用 MIT 许可证。付费套件有自己的商业许可证。

获取套件

入门套件（$19）——24 项陷阱检查清单 + 守护模式指南套装：https://whop.com/growl-ai/safe-ai-agent-starter-kit-guardrails-for-ai-agents
完整套件（$69 / 团队 $199）——100 项陷阱目录、可运行模块、破坏测试手册：https://growl-ai.com/store/en
背景阅读：幂等键详解（dev.to）