关于 AI Act Radar
AI Act Radar examples 是一组可运行的 Webhook 接收器示例，可在多个平台处理 AI Act Radar 事件，面向集成 Webhook 投递的开发者。各示例采用相同的签名验证和幂等处理逻辑。
主要功能
- 01支持六个平台的接收器
- 02HMAC-SHA-256 签名验证
- 03时间戳有效性检查
- 04幂等键处理
- 05已签名示例事件测试脚本
适用场景
- 01将 AI Act Radar Webhook 接入平台
- 02在本地测试已签名的 Webhook 事件
- 03构建可安全处理重试的接收器
MCP 相关
README 介绍的是 Webhook 接收器示例，没有提及 MCP 服务或 MCP 集成。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
服务地址
https://mcp.aiactradar.com/mcp/v1一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http com-aiactradar-ai-act-radar https://mcp.aiactradar.com/mcp/v1Cursor.cursor/mcp.json
{"mcpServers":{"com-aiactradar-ai-act-radar":{"type":"http","url":"https://mcp.aiactradar.com/mcp/v1"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"com-aiactradar-ai-act-radar":{"type":"http","url":"https://mcp.aiactradar.com/mcp/v1"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"com-aiactradar-ai-act-radar":{"type":"http","url":"https://mcp.aiactradar.com/mcp/v1"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"com-aiactradar-ai-act-radar":{"serverUrl":"https://mcp.aiactradar.com/mcp/v1"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://mcp.aiactradar.com/mcp/v1需要授权工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | |
| since | string | 否 | ISO 8601 时间戳；仅返回在此时间之后发布的事件。可选。 |
| until | string | 否 | ISO 8601 时间戳；仅返回在此时间之前发布的事件。可选。 |
| topics | array | 否 | 主题分类。例如：["gpai","transparency","high-risk"]。可选。 |
| source_id | string | 否 | 以下之一：eurlex、aioffice、aiboard、codeofpractice、haveyoursay、cen、bnetza、bfdi、bsi、cnil、nl-algoritmeregister、oecdai。可选。 |
| severity_min | enum | 否 | 最低严重程度。可选。info | low | medium | high | critical |
详细介绍
aiactradar-examples
AI Act Radar 的 Webhook 接收器参考示例。 每个子目录都是一个独立、可运行的平台示例。
每个接收器的功能
- 读取请求正文的原始内容（签名针对的是字节，而不是解析后的 JSON）。
- 验证
X-AIAR-Timestamp与当前时间相差不超过 300 秒。 - 使用 HMAC-SHA-256 对
<timestamp>.<raw_body>进行签名，并以恒定时间验证X-AIAR-Signature（v1=<hex>）。 - 在执行实际操作前检查幂等键（
event.id）——重试很常见。 - 在 5 秒内返回 2xx；否则分发器会采用指数退避策略重试。
各平台的验证逻辑完全相同，区别仅在于平台适配代码。
示例
| 文件夹 | 平台 | 备注 |
|---|---|---|
cloudflare-workers/ | Cloudflare Workers | Web Crypto API，使用 KV 实现幂等性 |
vercel-edge/ | Vercel Edge Functions | Web Crypto API，使用 Vercel KV 实现幂等性 |
aws-lambda/ | AWS Lambda + API Gateway | Node crypto 模块，使用 DynamoDB 实现幂等性 |
express-node/ | 基于 Node 的纯 Express | Node crypto，进程内 LRU（生产环境请替换） |
fastify-typescript/ | Fastify + TS | 类型化正文解析器，捕获原始正文 |
deno-deploy/ | Deno Deploy | 使用 Deno KV 实现幂等性 |
无需注册即可试用
每个示例都包含一个 test.sh，可使用本地密钥为示例事件签名，并将其发送到正在运行的接收器。你可以在笔记本电脑上用不到 5 分钟跑完整个流程：
cd cloudflare-workers
cp .dev.vars.example .dev.vars # set AIA_SECRET to anything
npm install && npm run dev # starts http://localhost:8787
# in another terminal:
bash test.sh # posts a signed sample event
准备投入生产
- 将
AIA_SECRET存储在平台的密钥管理器中。切勿提交它。 - 至少每 90 天在 AI Act Radar 控制面板中轮换一次密钥。
- 订阅分发器的 Webhook 健康状态频道——投递失败会先在此处显示，之后客户才会察觉。
- 幂等性存储的 TTL 至少需要 7 天；分发器最多会重试 24 小时。
许可证
MIT。
AI Act Radar 由位于 Karlsruhe 的 ligea GmbH 运营。信息仅供参考，不构成法律建议。
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。