Ground Truth MCP

Name: ground-truth-mcp
Author: anish632

让 AI 智能体使用来自网络的真实实时数据来验证其自身的声明。

MCP Cloudflare Workers Stripe

实时 URL: https://ground-truth-mcp.anish632.workers.dev

🎯 什么是 Ground Truth？

Ground Truth 是一个 MCP 服务器，为 AI 智能体提供事实核查和市场研究工具。智能体无需幻觉或猜测，即可实现：

✅ 检查 API 端点是否真实存在
📊 统计真实的竞争对手
💰 从网站提取实际定价
🔍 并排比较套餐
🔍 根据实时来源交叉核对声明
⚗️ 使用结构化测试验证假设

所有结果均来自实时获取的数据，并提供 5 分钟缓存以提升性能。

🚀 快速入门

免费层级（无需注册）

立即尝试 check_endpoint 工具：

curl -X POST https://ground-truth-mcp.anish632.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "check_endpoint",
      "arguments": {"url": "https://api.github.com"}
    },
    "id": 1
  }'

专业层级（每月 9 美元）

访问定价页面
通过 Stripe 订阅
获取您的 API 密钥：gt_live_...
添加到请求中：

curl -X POST https://ground-truth-mcp.anish632.workers.dev/mcp \
  -H "X-API-Key: gt_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"estimate_market","arguments":{"query":"react","registry":"npm"}},"id":1}'

🛠️ 可用工具

工具	免费？	描述
`check_endpoint`	✅ 是	探测任何 URL，获取状态、耗时、身份验证要求
`estimate_market`	💳 专业	统计 npm/PyPI 中的包以评估市场规模
`check_pricing`	💳 专业	从任何网站提取定价
`compare_competitors`	💳 专业	并排包比较
`verify_claim`	💳 专业	使用实时来源交叉核对声明
`test_hypothesis`	💳 专业	使用结构化测试进行自动化事实核查

完整 API 文档：API_USAGE.md

💰 定价

免费层级

check_endpoint - 永久免费使用

专业层级 - 每月 9 美元

所有 5 款高级工具 - 无限使用
5 分钟缓存 - 快速响应
99.9% 正常运行时间 SLA
随时取消 - 无任何附加条件

立即订阅 →

🏗️ 技术栈

运行时： Cloudflare Workers (边缘计算)
存储： 带有 SQLite 的 Durable Objects (缓存 + 使用日志)
API 密钥： Cloudflare KV (静态加密)
计费： Stripe Checkout + 订阅
协议： Model Context Protocol (MCP)
语言： TypeScript

📚 文档

SETUP.md - 部署与配置指南
API_USAGE.md - API 参考与示例
IMPLEMENTATION_SUMMARY.md - 实现细节

🔧 开发

先决条件

Node.js 18+
npm 或 pnpm
Cloudflare 账户
Stripe 账户

本地设置

克隆仓库：

cd "/Users/anishdas/Apps/Ground Truth/ground-truth-mcp"

安装依赖：
```
npm install
```

创建 KV 命名空间：

npx wrangler kv namespace create API_KEYS

使用 KV 命名空间 ID 更新 wrangler.jsonc

设置密钥：

npx wrangler secret put STRIPE_SECRET_KEY
npx wrangler secret put STRIPE_WEBHOOK_SECRET

本地运行：
```
npm start
# or
npx wrangler dev
```
部署：
```
npm run deploy
# or
npx wrangler deploy
```

完整设置指南：SETUP.md

🧪 测试

测试免费层级（无需认证）

curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "check_endpoint",
      "arguments": {"url": "https://example.com"}
    },
    "id": 1
  }'

测试认证拒绝

# Should return 402 (payment required)
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "estimate_market",
      "arguments": {"query": "test", "registry": "npm"}
    },
    "id": 1
  }'

测试 Stripe 结账

访问 http://localhost:8787/pricing
点击 "Subscribe Now"
使用测试卡：4242 4242 4242 4242
完成结账
在成功页面验证显示的 API 密钥

🔐 安全性

API 密钥： 存储在 Cloudflare KV 中（静态加密）
Stripe 密钥： 作为 Worker 密钥存储（加密）
Webhook 验证： 签名验证（针对 MVP 简化）
密钥撤销： 订阅取消时标记为无效
审计追踪： 密钥不会被删除，仅标记为无效

🚦 状态与监控

主页： https://ground-truth-mcp.anish632.workers.dev
统计： https://ground-truth-mcp.anish632.workers.dev/stats
Stripe 控制台： https://dashboard.stripe.com
Cloudflare 控制台： https://dash.cloudflare.com

📊 架构

┌─────────────┐
│   User      │
└──────┬──────┘
       │
       ├─── Free Tier (no auth)
       │    └─► check_endpoint
       │
       ├─── Pro Tier (API key)
       │    ├─► X-API-Key header
       │    ├─► Validate against KV
       │    └─► estimate_market, check_pricing, etc.
       │
       └─── x402 (fallback)
            └─► Crypto payment for single call
       
┌─────────────────────────────────────┐
│   Cloudflare Worker                  │
├─────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐ │
│  │ Auth         │  │ Stripe       │ │
│  │ Middleware   │  │ Integration  │ │
│  └──────────────┘  └──────────────┘ │
│         │                 │          │
│  ┌──────▼──────┐  ┌──────▼────────┐ │
│  │ KV Store    │  │ Durable       │ │
│  │ (API Keys)  │  │ Objects       │ │
│  └─────────────┘  │ (Cache+Logs)  │ │
│                   └───────────────┘ │
└─────────────────────────────────────┘

🤝 贡献

目前不接受外部贡献（私有项目），但欢迎分叉以供个人使用。

📜 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

🆘 支持

电子邮件： anishdasmail@gmail.com
问题反馈： https://github.com/anish632/ground-truth-mcp/issues
Twitter： @anish632

🎯 使用场景

面向 AI 智能体

在展示研究结果前验证市场调研
根据实时来源核实声明
使用真实数据比较竞争对手
通过结构化验证测试假设

面向开发者

在推荐 API 之前进行预验证
无需手动网页抓取即可检查定价
估算包数量以进行市场规模分析
在 CI/CD 中进行自动化事实核查

面向研究人员

使用实时数据交叉核对声明
跟踪包版本随时间的变化
监控定价变动
验证学术假设

🏆 Ground Truth 有何不同？

✅ 实时数据： 无陈旧数据库，所有结果均来自实时获取 ✅ 缓存： 5 分钟缓存，在不牺牲新鲜度的前提下提升性能 ✅ MCP 原生： 从第一天起就为 AI 智能体构建 ✅ 边缘计算： 来自 Cloudflare 全球网络的快速响应 ✅ 免费层级： 无需信用卡即可尝试 ✅ 透明定价： 每月 9 美元，无限使用，无隐藏费用 ✅ x402 回退： 如果不想订阅，可按调用付费（加密货币）

📈 路线图

[x] 核心事实核查工具
[x] Stripe 计费集成
[x] API 密钥认证
[x] 免费层级 (check_endpoint)
[x] 订阅 Webhook 处理
[ ] 使用情况分析仪表板
[ ] 电子邮件通知
[ ] 团队账户
[ ] 企业层级
[ ] 自定义集成

🙏 致谢

使用 MCP SDK 构建
由 Cloudflare Workers 提供支持
支付由 Stripe 处理
x402 集成由 @x402 提供

由 Anish Das ❤️ 制作

最后更新：2026 年 3 月 20 日

ground-truth-mcp