关于 AgentSeal
AgentSeal 是一款 MCP 服务,将 AI Agent 的操作记录到具备防篡改特性的 SHA-256 哈希链中,适用于需要查询活动并验证审计记录完整性的团队。
主要功能
- 01将 Agent 操作写入审计记录
- 02以 SHA-256 哈希链接记录
- 03按 Agent 或类型查询操作
- 04验证哈希链完整性
适用场景
- 01记录重要 Agent 操作以供审计
- 02查看特定 Agent 执行过的操作
- 03检查审计记录是否被修改
MCP 相关
MCP 服务提供记录、查询和验证 AgentSeal 审计记录的工具。客户端使用 AGENTSEAL_API_KEY 进行身份验证。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| agent_id | string | 是 | 此 Agent 的标识符(例如 'research-bot'、'finance-agent') |
| action_type | string | 是 | 所执行操作的类型(例如 'email:send'、'file:write'、'api:call'、'db:query') |
| action_params | object | 否 | 操作的参数(例如 {to: '[email protected]', subject: '...'}) |
| reasoning | string | 否 | 你决定执行此操作的原因——你的思维链 |
| authorized_by | string | 否 | 授权此操作的人员或机制(例如 'user:alice'、'policy:auto-approve') |
详细介绍
agentseal-mcp
面向 AgentSeal 的 MCP 服务。使用 SHA-256 哈希链,为 AI Agent 提供防篡改审计日志。
每个 Agent 操作都会记录在哈希链中。这样,你就能向客户证明 Agent 确实完成了它声称完成的操作。
设置
Claude Desktop
将以下内容添加到你的 claude_desktop_config.json:
{
"mcpServers": {
"agentseal": {
"command": "npx",
"args": ["-y", "agentseal-mcp"],
"env": {
"AGENTSEAL_API_KEY": "as_sk_your_key_here"
}
}
}
}
保存后重启 Claude Desktop。
Cursor / 其他 MCP 主机
配置相同——使用你的 API 密钥添加该服务。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
AGENTSEAL_API_KEY | 是 | 你从 agentseal.io 获取的 API 密钥 |
AGENTSEAL_URL | 否 | 自定义 API 基础 URL(默认为生产环境) |
工具
record_action
将 Agent 操作记录到审计日志中。在重要操作后调用此工具,以创建一条经过加密链接的记录,说明发生了什么以及原因。
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
agent_id | string | 是 | Agent 的标识符(例如 research-bot) |
action_type | string | 是 | 操作类型(例如 email:send、file:write、api:call) |
action_params | object | 否 | 操作详情 |
reasoning | string | 否 | Agent 决定执行此操作的原因 |
authorized_by | string | 否 | 批准此操作的人或事物 |
返回序列号和 SHA-256 哈希,以确认该条目已链接到哈希链中。
query_actions
从审计日志中查找此前记录的操作。可用此工具查看已执行的操作或回顾过去的决策。
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
agent_id | string | 否 | 按 Agent 筛选 |
action_type | string | 否 | 按操作类型筛选 |
limit | number | 否 | 返回的最大条目数(默认值为 20) |
verify_chain
验证哈希链的完整性。每个条目的 SHA-256 哈希都包含前一个条目的哈希——如果任何记录被修改,哈希链就会断裂,此工具会报告断裂位置。
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
agent_id | string | 否 | 验证特定 Agent 的哈希链。若省略,则验证所有条目。 |
返回已验证的条目数,以及哈希链是否完整。
工作原理
每个记录的操作都会使用 SHA-256 进行哈希处理。该哈希包含前一个条目的哈希,从而形成哈希链。修改任意记录都会导致其后的所有哈希发生变化——verify_chain 会立即检测到。
获取 API 密钥
在 agentseal.io 注册。免费使用。
Python SDK
无需 MCP 的直接集成方式:pip install agentseal-sdk。参见 agentseal-sdk。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。