Ground Truth MCP

地面实况

AI代理的实时事实检查工具。

Ground Truth为人工智能代理提供了实时公共数据的只读验证工具：免费的端点可达性检查、免费的安全标头检查、定价页面扫描、定价页面比较、证据支持的索赔检查、包裹市场规模、合规性扫描、命名包裹比较和多步骤假设检验。

您可以通过三种方式使用地面真相：

• 免费的端点和安全标头检查，用于轻量级验证
• 使用x402兼容客户端或xpay代理进行代理按次付费
• 团队订阅 X-API-Key 计费和可预测的每月使用量

  

直播： https://ground-truth-mcp.anishdasmail.workers.dev

______________________________________________________________________

先试试这个

这两个工具在没有注册或API密钥的情况下工作：

• check_endpoint：验证公共URL或API终结点是否响应。
• inspect_security_headers：检查HSTS、CSP、帧保护和相关的面向浏览器的安全标头。

示例提示：

• “使用地面真相来检查https://api.github.com回答。"
• “使用地面实况检查安全标头https://example.com."
• 在推荐此API之前，请使用Ground Truth验证终结点是否可访问

______________________________________________________________________

什么是地面真相

地面真相帮助特工在回答、推荐或采取行动之前检查事实。

所有结果都来自实时数据，并缓存5分钟，以便更快地重复检查。

______________________________________________________________________

补充MCP服务器

当与更广泛的发现或浏览器工具配对时，地面真相最强：

• Tavily MCP服务器 用于在运行索赔或定价检查之前进行实时网络搜索和内容发现。
• Firecrawl MCP服务器 用于在原始HTML启发式方法不足时进行更深入的爬行和JS繁重的页面提取。
• Mcp服务器眉 用于在需要点击、身份验证或客户端呈现的页面上进行交互式浏览器验证。

这些是对地面真相的补充，而不是替代：它们帮助你找到或呈现页面，而地面真相帮助你验证由此产生的声明。

______________________________________________________________________

为什么AI代理需要验证

训练数据过时。文档更改。定价变化。竞争对手出现了。端点中断。政策在动。

地面真相为特工提供了一种在做出承诺之前进行检查的方法：

• 在报价之前，拉取实时定价页面
• 在比较供应商之前，请并排浏览他们的实时定价页面
• 在重复合规声明之前，请扫描实时信任页面
• 在断言安全基线之前，请检查响应标头
• 在说竞争对手不存在之前，请搜索实时注册表
• 在推荐API之前，确认端点响应
• 在调用一个更受欢迎的包之前，请比较真实的包元数据
• 在重复策略之前，请验证当前公共页面上的语言

结果很简单：由于错误的原因，代理人不那么自信，但在重要的时候更可靠。

______________________________________________________________________

示例工作流

验证定价声明

“团队每个用户每月的Notion费用为8美元。”

使用 check_pricing 在重复数字之前，请先在实时定价页面上查看。

检查是否存在竞争对手

“Prisma没有好的边缘ORM替代品。”

使用 estimate_market 在npm中搜索 edge orm 看看已经存在的东西。

比较供应商定价页面

“供应商A比供应商B便宜。”

使用 compare_pricing_pages 在重复索赔之前，比较实时定价页面。

扫描信任页面

“该供应商支持SOC 2、GDPR和SCIM。”

使用 assess_compliance_posture 在将其视为当前事实之前。

检查面向浏览器的安全标头

“这款应用程序具有强大的公共安全基线。”

使用 inspect_security_headers 在提出索赔之前。

验证API终结点

“使用OpenAI /v1/models 端点以列出可用模型。"

使用 check_endpoint 在文档、代码或支持回复中推荐它之前。

比较套餐受欢迎程度

“Vue已经超越了React。”

使用 compare_competitors 比较实时包元数据而不是猜测。

检验市场假设

“npm上的MCP工具不到50个。”

使用 test_hypothesis 使用基于计数的检查并返回实际结果。

确认是否适用支持策略

“AWS业务支持包括全天候电话支持。”

使用 verify_claim 在将其视为事实之前，请查看当前的AWS支持页面。

______________________________________________________________________

访问模式

自由

免费层包括每月有限的端点和安全标头检查。

• check_endpoint
• inspect_security_headers
• 每个日历月100个请求
• 在生产中由Cloudflare客户端IP跟踪，或 X-Anonymous-Client-Id 用于本地/开发测试
• 不需要注册或API密钥

代理按次付费

付费工具还支持代理按使用付费。

• 使用兼容x402的MCP客户端，或 xpay MCP代理 在此服务器前面
• 工具定价起始于 $0.01 每次通话，因工具而异
• 最适合自主代理或可变工作负载
• 包含 estimate_market, check_pricing, compare_pricing_pages, compare_competitors, verify_claim, assess_compliance_posture，以及 test_hypothesis

团队

团队订阅使用API-key计费，每月使用量可预测。

• 需要 X-API-Key 使用主动计费
• 默认配额为每个日历月5000个请求
• 每月跟踪API密钥和工具的使用情况
• 包括所有付费验证工具

查看定价

______________________________________________________________________

API示例

直接API curl

直接HTTP调用 /mcp 是基于会话的。初始化一次，保留返回的 mcp-session-id，然后使用该标头调用工具。

以下示例使用团队计划 X-API-Key。对于代理按使用付费，请使用支持x402的MCP客户端或在此服务器前放置xpay代理。

SESSION_ID="$(curl -i -s -X POST https://ground-truth-mcp.anishdasmail.workers.dev/mcp \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "ground-truth-example",
        "version": "1.0.0"
      }
    },
    "id": 0
  }' | tr -d '\r' | awk '/^mcp-session-id:/ {print $2}')"

curl -X POST https://ground-truth-mcp.anishdasmail.workers.dev/mcp \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -H "X-API-Key: $GROUND_TRUTH_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "check_pricing",
      "arguments": {
        "url": "https://stripe.com/pricing"
      }
    },
    "id": 1
  }'

JavaScript fetch

const initResponse = await fetch("https://ground-truth-mcp.anishdasmail.workers.dev/mcp", {
  method: "POST",
  headers: {
    "Accept": "application/json, text/event-stream",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    method: "initialize",
    params: {
      protocolVersion: "2025-03-26",
      capabilities: {},
      clientInfo: {
        name: "ground-truth-example",
        version: "1.0.0",
      },
    },
    id: 0,
  }),
});

const sessionId = initResponse.headers.get("mcp-session-id");

if (!sessionId) {
  throw new Error("Missing mcp-session-id from initialize response");
}

const response = await fetch("https://ground-truth-mcp.anishdasmail.workers.dev/mcp", {
  method: "POST",
  headers: {
    "Accept": "application/json, text/event-stream",
    "Content-Type": "application/json",
    "Mcp-Session-Id": sessionId,
    "X-API-Key": process.env.GROUND_TRUTH_API_KEY,
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    method: "tools/call",
    params: {
      name: "compare_competitors",
      arguments: {
        packages: ["react", "vue"],
        registry: "npm",
      },
    },
    id: 1,
  }),
});

const result = await response.json();
console.log(result);

自由端点检查

curl -X POST https://ground-truth-mcp.anishdasmail.workers.dev/mcp \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "check_endpoint",
      "arguments": {
        "url": "https://api.github.com"
      }
    },
    "id": 1
  }'

免费访问、团队计划计费、无效密钥、非活动计费、配额强制和活动付费访问的轻量级请求检查 使用强制测试.sh.

______________________________________________________________________

MCP设置

如果您使用Claude Desktop、Cursor或其他MCP客户端，Ground Truth可以作为您的代理的验证工具插入。

MCP代表 模型上下文协议。这是让AI应用程序调用外部工具的标准。

如果你想在不更改应用程序代码的情况下进行代理按次付费，请使用xpay注册此MCP URL，并共享生成的代理URL。

克劳德桌面版

将此添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ground-truth": {
      "url": "https://ground-truth-mcp.anishdasmail.workers.dev/mcp",
      "headers": {
        "X-API-Key": "gt_live_your_key_here"
      }
    }
  }
}

光标

将此添加到 .cursor/mcp.json 在您的项目或 ~/.cursor/mcp.json 全球地：

{
  "mcpServers": {
    "ground-truth": {
      "url": "https://ground-truth-mcp.anishdasmail.workers.dev/mcp",
      "headers": {
        "X-API-Key": "gt_live_your_key_here"
      }
    }
  }
}

Claude代码技能

如果您希望在不运行服务器的情况下使用相同的工作流，请参阅 克劳德技能/.

______________________________________________________________________

用例

支持

• 在将定价声明发送给客户之前进行验证
• 在升级之前检查支持策略是否适用
• 在回复中推荐API端点之前，确认该端点存在
• 在重复安全声明之前检查公共安全标头

产品

• 在编写规范之前，测试市场假设是否真实
• 在制定路线图之前，检查是否存在竞争对手
• 在选择平台之前，比较软件包的受欢迎程度
• 在告诉团队一个供应商更便宜之前，先比较定价页面

合规

• 扫描SOC 2、GDPR、HIPAA、DPA、SSO和SCIM信号的信任页面
• 在内部重复之前，核实定价或包装声明
• 检查公共条款或策略URL是否可访问并且是最新的

安全和供应商尽职调查

• 在实时页面上比较竞争对手的定价
• 在推荐或批准供应商之前，检查面向浏览器的安全标头
• 通过结构化检查验证定位声明

______________________________________________________________________

工具参考

完整参考： API_USAGE.md

______________________________________________________________________

建筑

Ground Truth保留了当前的Cloudflare Workers架构：

• 运行时：Cloudflare Workers
• 存储：具有SQLite的持久对象，用于缓存和使用日志
• API密钥：Cloudflare KV
• 账单：Stripe团队订阅加上x402兼容的按次付费
• 协议：MCP
• 语言：TypeScript

______________________________________________________________________

分布

Ground Truth是为多种发现和货币化路径而设立的：

• MCP注册处官方发布 server.json 用于整个生态系统的发现。
• Smithery出版社。 smithery.yaml 定义HTTP配置架构（可选 X-API-Key)Smithery的安装按钮和释放流程。使用Smithery的 发布 仪表板中的按钮，用于在部署后创建新版本。
• xpay MCP货币化。您可以注册直播 /mcp 使用xpay获取托管的按工具付费代理的URL，而无需更改服务器代码。
• MCP市场目录列表，以获取更多信息。
• 如果你以后想要一个单独的市场原生Actor版本，Apify是可选的；当前项目针对远程MCP交付而不是Actor第一运行时保持优化。

______________________________________________________________________

发展

cd ground-truth-mcp
npm install
npx wrangler dev

部署说明已上线 设置.md.

______________________________________________________________________

GitHub 发布

当您推送匹配的版本标记时，会自动创建稳定的GitHub版本 v*.

git tag v0.4.0
git push origin v0.4.0

该标签会触发 ，它对项目进行类型检查，并从标签中发布GitHub版本。这是Glama在维护扫描期间用于检测稳定版本的回购侧件。

______________________________________________________________________

Glama释放

Glama版本是基于Docker的，而不是GitHub版本。此回购包括 Dockerfile 通过港口上的牧马人在本地启动Worker 3000.

docker build -t ground-truth-mcp .
docker run --rm -p 3000:3000 ground-truth-mcp

对于Glama流：

1. 在Glama中声明服务器。
2. 打开Dockerfile管理页面，使用此存储库 Dockerfile，并运行部署测试。
3. 部署测试成功后，单击 发布，选择一个版本，然后发布。
4. 如果分数页面仍然显示 No LICENSE，GitHub识别出根后，在Glama管理界面中触发重新扫描 LICENSE 文件。
5. 如果分数页面仍然显示 No related servers，使用 添加相关服务器 在声称的Glama UI中添加 Tavily MCP Server, Firecrawl MCP Server，以及 mcp-server-browserbase。该清单项目由Glama管理，而不是由 glama.json.

如果Glama生成 mcp-proxy-基于构建规范而不是使用存储库 Dockerfile，将命令指向 npm run start:glama:stdio该网桥通过stdio暴露了现有的远程地面真相MCP端点，因此 mcp-proxy 可以主持它。

______________________________________________________________________

文档

• API_USAGE.md 用于API调用和工具参数
• 设置.md 用于部署和计费设置
• 克劳德技能/ 对于零部署的Claude Code版本

______________________________________________________________________

支持

• 电子邮件：anishdasmail@gmail.com
• 网站：https://ground-truth-mcp.anishdasmail.workers.dev/

______________________________________________________________________

许可证

麻省理工学院——见 许可证

______________________________________________________________________

由...制作 Anish 这

_最后更新日期：2026年4月29日_