关于 GAIP Witness Agent
GAIP Witness Agent 属于 GAIP,可记录 AI Agent、MCP 服务和网店的带日期事实,并返回签名回执。Witness 的介绍聚焦约定条款与交付核查、争议材料包和证据包,用于记录交易相关信息。
主要功能
- 01记录公开信息及其日期
- 02为回答生成签名回执
- 03通过连续性标识关联历史
- 04用 GitHub Actions 检查与监控变更
适用场景
- 01记录约定条款与交付核查结果
- 02整理争议所需的证据
- 03在 CI 中监控依赖项变更
MCP 相关
可通过无需登录的流式 HTTP 地址 https://www.gaipagents.com/mcp 供 MCP 客户端连接,提供包括 `gaip_check` 在内的 GAIP 查询;README 未说明 Witness 专属工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://www.gaipagents.com/mcp/agents/witnessclaude mcp add --transport http tjcgraham-rgb-gaip-witness https://www.gaipagents.com/mcp/agents/witness{"mcpServers":{"tjcgraham-rgb-gaip-witness":{"type":"http","url":"https://www.gaipagents.com/mcp/agents/witness"}}}在 Cursor 中打开{"servers":{"tjcgraham-rgb-gaip-witness":{"type":"http","url":"https://www.gaipagents.com/mcp/agents/witness"}}}在 VS Code 中打开{"mcpServers":{"tjcgraham-rgb-gaip-witness":{"type":"http","url":"https://www.gaipagents.com/mcp/agents/witness"}}}{"mcpServers":{"tjcgraham-rgb-gaip-witness":{"serverUrl":"https://www.gaipagents.com/mcp/agents/witness"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
23| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| checks | array | 否 | 1-8 项检查,每项可为 {"id": "http_status_in", "allowed": [200]}、{"id": "content_type_is", "value": "application/json"}、{"id": "non_empty"}、{"id": "json_parses"}、{"id": "json_required_keys", "keys": ["a.b"]}、{"id": "json_path_equals", "path": "a.b", "value": 1}、{"id": "max_latency_ms", "limit": 2000}、{"id": "max_bytes", "limit": 20000}、{"id": "text_contains", "value": "ok"} 或 {"id": "regex", "pattern": "ok|up"}。 |
| seller_ref | string | 否 | 可选:供应商名称。默认使用 service_url 的主机名。 |
| service_url | string | 是 | 服务的公开 https URL。 |
| research_consent | boolean | 否 | 可选,默认值为 false。设为 true 后,此记录可计入 GAIP 的月度汇总研究数据(例如供保险公司使用),但不会披露名称。 |
| data_classification | enum | 否 | PUBLIC(默认)或 NON_PERSONAL_PUBLIC。切勿发送个人数据。PUBLIC | NON_PERSONAL_PUBLIC |
详细介绍
GAIP
GAIP,即 Governed Agentic Intelligence Platform,会独立记录 AI Agent、MCP 服务和在线商店发布的内容及其日期,并通过带签名的回执回答有关这些记录的问题。免费、只读、无需密钥;提供指定时间的事实,绝不作出评估。
**首次调用:**在 https://www.gaipagents.com/mcp 上,使用带有 url 的 gaip_check。此调用可直接运行;接着使用你所关注的 Agent、MCP 服务或 API 的 URL:
curl -s https://www.gaipagents.com/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gaip_check","arguments":{"url":"https://mcp.deepwiki.com/mcp"}}}'
无需 MCP:GET https://www.gaipagents.com/v1/free/conformance/check?url=<url>。
**问题地图:**GAIP 能回答的所有问题,按提问者分类,并列出对应的工具和 HTTP 路由: https://www.gaipagents.com/v1/free/map。每个已完成的回答都会附带一个连续性句柄;将其发回后,回答便会与您在 GAIP 的历史记录关联。
一行连接
| 位置 | 一行连接 |
|---|---|
| 任意 MCP 客户端 | https://www.gaipagents.com/mcp(可流式传输的 HTTP,无需登录) |
| Claude Code | claude mcp add --transport http gaip https://www.gaipagents.com/mcp,或使用插件(MCP 服务和技能):/plugin install gaip --marketplace tjcgraham-rgb/gaip-agents |
| Claude Desktop / claude.ai | Customize > Connectors > Add custom connector,URL 为 https://www.gaipagents.com/mcp,无需登录 |
| Agent Skills(Claude Code、Cursor、Codex 等) | npx skills add tjcgraham-rgb/gaip-agents(安装 skills/gaip/SKILL.md) |
| Cursor、VS Code | 使用下方按钮,或 { "mcpServers": { "gaip": { "url": "https://www.gaipagents.com/mcp" } } } |
| Gemini CLI | gemini extensions install https://github.com/tjcgraham-rgb/gaip-agents |
| OpenAI Agents SDK | HostedMCPTool(tool_config={"type": "mcp", "server_label": "gaip", "server_url": "https://www.gaipagents.com/mcp", "require_approval": "never"}) |
| Vercel AI SDK | await createMCPClient({ transport: { type: 'http', url: 'https://www.gaipagents.com/mcp' } })(来自 @ai-sdk/mcp) |
| LangChain | pip install langchain-gaip,然后运行 from langchain_gaip import get_tools |
| CrewAI | Agent(..., mcps=["https://www.gaipagents.com/mcp"]) |
| A2A(1.0 和 0.3.0) | Agent 卡片:https://www.gaipagents.com/.well-known/agent-card.json;纯文本也可使用 |
| x402 | 无需设置:GAIP 免费,且绝不会以 HTTP 402 作出响应(https://www.gaipagents.com/.well-known/x402) |
| Windsurf | ~/.codeium/windsurf/mcp_config.json:{ "mcpServers": { "gaip": { "serverUrl": "https://www.gaipagents.com/mcp" } } } |
| Cline | { "mcpServers": { "gaip": { "type": "streamableHttp", "url": "https://www.gaipagents.com/mcp" } } }(参见 llms-install.md) |
| 其他所有平台,附带可复制粘贴的代码 | https://www.gaipagents.com/docs/quickstart |
在 CI 中:两个 GitHub Actions
GAIP Watch:当你的 Agent 所依赖的 MCP 服务或 Agent 更改了工具、架构、登录要求或价格时,构建将失败,并附带带日期的回执(watch/):
- uses: tjcgraham-rgb/gaip-agents/watch@main
with:
urls: https://mcp.example.com/mcp
GAIP Agents check:每次推送时,都会在你自己的 Agent 卡片、MCP 服务或 OpenAPI 文档上运行 gaip_check:
- uses: tjcgraham-rgb/gaip-agents@v1
with:
agent-url: https://your-agent.example/.well-known/agent-card.json
fail-on-error: "true"
输出:verdict(READY、FIXES_NEEDED、UNREACHABLE 或 NOT_CHECKED)、receipt-id、error-count、warning-count。
服务提供商可以通过徽标展示自己的带日期记录:
https://www.gaipagents.com/v1/free/watch/badge.svg?url=<your endpoint>。
本仓库内容
| 路径 | 内容 |
|---|---|
registry/ | Official MCP Registry 记录:gaip-broker.json(GAIP 本身)以及每个专业 Agent 各一条记录 |
listing-kit.json | 供目录使用的说明句、首次调用、地图行、端点和调用示例(也通过 /v1/free/discovery/listing-kit 提供) |
skills/gaip/SKILL.md | 作为 Agent Skill 的 GAIP(agentskills.io 格式;也通过 /.well-known/agent-skills/gaip/SKILL.md 提供) |
.claude-plugin/ | Claude Code 插件和市场清单:技能及远程 MCP 服务 |
.cursor-plugin/plugin.json, mcp.json | Cursor 插件清单及其 MCP 服务 |
gemini-extension.json, GEMINI.md | Gemini CLI 扩展:安装 GAIP 的 MCP 服务,并告知模型何时使用各工具 |
packages/gaip-check/ | Python 客户端:check_agent("https://other-agent.example") |
action.yml, packages/gaip-check-action/ | 检查 Action(uses: tjcgraham-rgb/gaip-agents@v1) |
watch/ | GAIP Watch Action |
packages/aipref-signals/ | 用于 AI 偏好信号的无依赖解析器和测试向量(IETF AI Preferences Content-Usage、RSL 许可链接、W3C TDMRep、Content Signals) |
assets/ | GAIP 徽标(SVG 和 400×400 PNG)及专业图标(SVG) |
llms-install.md | 为自行设置 MCP 服务的 AI 助手(Cline)提供的安装步骤 |
注册记录、清单工具包、软件包、Watch Action、技能和 Gemini 扩展,都是 GAIP 服务生成内容的副本;服务仓库中的检查会在此处的副本与最新内容不一致时发出警告。服务本身运行于 www.gaipagents.com。
答案的含义
每个答案都会说明观察到的内容及观察时间。它不是认证、背书、排名或通用评分,也不是法律、财务或保险建议。回执使用 GAIP 的 Ed25519 密钥签名,密钥发布于 https://www.gaipagents.com/.well-known/gaip-receipt-keys.json。
- 条款:https://www.gaipagents.com/terms
- 隐私:https://www.gaipagents.com/privacy
- 更正和退出选项:https://www.gaipagents.com/corrections
- 方法论:https://www.gaipagents.com/methodology
- 安全联系信息:https://www.gaipagents.com/.well-known/security.txt
许可证
本仓库中的所有内容均采用 MIT 许可证(参见 LICENSE)。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
