Guard Core

---

面向 Guard 生态的模型上下文协议服务：为 Agent 和开发者提供配置验证、文档搜索和语料库工具。

网站 · 文档 · 体验平台 · 控制面板 · Discord

---

生态系统

Guard Core 是 Python 引擎。框架适配器是轻量封装，用于将原生请求/响应类型转换为 Guard Core 的协议。遥测 Agent 会将安全事件和指标发送到监控后端。Go、PHP、TypeScript（在 npm 上发布）和 Rust（在 crates.io 上发布）也有并行的引擎实现——它们都是对相同参考语义的移植，并通过共享的对抗性测试集进行一致性测试。

Python

包	作用	PyPI
guard-core	与框架无关的安全引擎
guard-agent	遥测 Agent
fastapi-guard	FastAPI / Starlette 适配器
flaskapi-guard	Flask 适配器
djapi-guard	Django 适配器
tornadoapi-guard	Tornado 适配器

Go

通过 GitHub 发布版本发布 Go 模块。已可用于生产环境。

包	作用	发布版本
guard-core-go	Go 引擎
nethttp-guard	net/http 适配器
gin-guard	Gin 适配器
echo-guard	Echo（v4）适配器
fiber-guard	Fiber（v3）适配器
guard-agent-go	遥测 Agent

PHP

以 rennf93 vendor 名称发布在 Packagist 上。可用于生产环境。

软件包	作用	Packagist
guard-core-php	PHP 引擎
laravel-guard	Laravel 适配器
symfony-guard	Symfony 适配器
psr15-guard	PSR-15 适配器
slim-guard	Slim 4 适配器
guard-agent-php	遥测 Agent

TypeScript / JavaScript

以 @guardcore npm 作用域发布；源代码位于 guard-core-ts monorepo 中。可用于生产环境。

软件包	作用	npm
	@guardcore/core	核心引擎
@guardcore/express	Express 适配器
@guardcore/nestjs	NestJS 适配器
@guardcore/fastify	Fastify 适配器
@guardcore/hono	Hono（边缘）适配器
guardagent	遥测 Agent

Rust

已发布到 crates.io。可用于生产环境。

软件包	作用	crates.io
guard-core-engine	核心引擎 crate
guard-core-rs	门面 crate（使用者入口点）
actix-guard-rs	Actix Web 适配器
axum-guard-rs	Axum 适配器
tower-guard-rs	Tower 适配器
rocket-guard-rs	Rocket 适配器
guard-agent-rs	遥测 Agent

AI 编码 Agent

软件包	作用	PyPI
guard-core-mcp	MCP 服务：配置验证、文档搜索、检测沙箱

---

文档

📚 文档 - 此软件包的完整技术文档。

🛡️ Guard Core - 引擎的参考文档。

🤖 监控 Agent 集成 - 使用监控 Agent 监控你的 Guard 实例。

---

为什么

你的 Agent 已经能阅读文档。它做不到的是告诉你，配置中的 redis_failopen 实际上毫无作用，因为正确的字段是 redis_fail_open；或者你想使用的标志直到 guard-core 3.5.0 才加入；又或者某个请求实际上是否会被拦截，以及会被哪个模式拦截。

此服务会从已安装的软件包中给出答案：真正的 pydantic 验证、真实的字段元数据，以及实际的检测引擎。它还可以回答这些库无法回答的跨语言问题：哪个软件包能保护 Gin、Fastify、Laravel 或 Rocket 应用，它是通过标签识别还是仍依赖路径，如何接入其遥测 Agent，以及 SaaS 接收端点会返回哪些响应代码。

安装

将它安装到项目的环境中，而不是作为独立工具安装：

uv add --dev guard-core-mcp
claude mcp add guard-core -- uv run guard-core-mcp

uvx guard-core-mcp 可以启动，但隔离环境中没有 guard-core 或 fastapi-guard 供它检查，因此它只能根据内置文档回答。在你自己的环境中运行，才能确保答案与你实际发布的版本相符。

工具

工具	可解答的问题
versions	这里安装了哪些 Guard 库，版本号是多少
validate_config	此配置是否有效，包括 pydantic 会静默忽略的拼写错误键
config_fields	这个设置是什么，默认值是什么，是否存在 X 的设置
search_docs	文档在哪些地方介绍了这个主题
get_doc	某个文档页面的全文
check_payload	此请求会被拦截吗，会被哪个模式拦截
ecosystem	完整的注册表矩阵：5 种语言、引擎、适配器、Agent、一致性、SaaS 合约
adapter_setup	为一个适配器安装并配置经过验证的最小集成（例如 go + gin）
wire_agent	如何为某种语言设置遥测 Agent，包括数据摄取合约

生态系统工具只提供纯数据，因此无论是否安装 Python 库，都可以使用。每段快速入门代码片段均逐字复制自同级仓库的 README；release_status 会如实告知软件包处于 published、tagged 还是仍为 untagged 状态（仅有源代码、main 或路径依赖）。

ChatGPT 插件

这些工具也可通过 https://mcp.guard-core.com/mcp 远程使用，并作为 ChatGPT 插件提供：使用 guard-core 账户登录后，ChatGPT 就能验证配置、搜索文档，并通过托管的检测引擎运行载荷（使用最新发布的版本，而非你的本地版本）。插件打包文件位于 plugin/，托管服务端位于 guard_core_mcp.hosting；完整说明（环境变量、Docker 镜像、开发者模式测试循环、提交清单）请参阅 ChatGPT 插件指南。

许可证

MIT

mcp-name: io.github.Guard-Core/guard-core-mcp