Ground Truth MCP

Name: ground-truth-mcp
Author: anish632

Lassen Sie KI-Agenten ihre eigenen Behauptungen mit echten Live-Daten aus dem Web validieren.

MCP Cloudflare Workers Stripe

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

🎯 Was ist Ground Truth?

Ground Truth ist ein MCP-Server, der KI-Agenten Tools zur Faktenprüfung und Marktforschung bereitstellt. Anstatt zu halluzinieren oder zu raten, können Agenten:

✅ Prüfen, ob ein API-Endpunkt tatsächlich existiert
📊 Echte Marktkonkurrenten zählen
💰 Tatsächliche Preise von Websites extrahieren
🔍 Pakete direkt miteinander vergleichen
🧪 Behauptungen anhand von Live-Quellen abgleichen
⚗️ Hypothesen mit strukturierten Tests überprüfen

Alle Ergebnisse stammen aus Live-Daten, die in Echtzeit abgerufen werden, mit einem 5-Minuten-Caching für optimale Leistung.

🚀 Schnellstart

Kostenlose Stufe (Keine Registrierung)

Testen Sie das check_endpoint-Tool sofort:

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
  }'

Pro-Stufe (9 $/Monat)

Besuchen Sie die Preisseite
Abonnieren Sie via Stripe
Erhalten Sie Ihren API-Schlüssel: gt_live_...
Zu Anfragen hinzufügen:

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}'

🛠️ Verfügbare Tools

Tool	Kostenlos?	Beschreibung
`check_endpoint`	✅ Ja	Untersuchen Sie jede URL, erhalten Sie Status, Timing, Authentifizierungsanforderungen
`estimate_market`	💳 Pro	Zählen Sie Pakete in npm/PyPI, um die Marktgröße einzuschätzen
`check_pricing`	💳 Pro	Extrahieren Sie Preise von jeder Website
`compare_competitors`	💳 Pro	Paketvergleich Seite an Seite
`verify_claim`	💳 Pro	Abgleich von Behauptungen mit Live-Quellen
`test_hypothesis`	💳 Pro	Automatisierte Faktenprüfung mit strukturierten Tests

Vollständige API-Dokumentation: API_USAGE.md

💰 Preise

Kostenlose Stufe

check_endpoint - Für immer unbegrenzt

Pro-Stufe - 9 $/Monat

Alle 5 Premium-Tools - Unbegrenzte Nutzung
5-Minuten-Caching - Schnelle Antworten
99,9 % Verfügbarkeits-SLA
Jederzeit kündbar - Keine Fragen gestellt

Jetzt abonnieren →

🏗️ Tech-Stack

Laufzeit: Cloudflare Workers (Edge Computing)
Speicher: Durable Objects mit SQLite (Caching + Nutzungsprotokolle)
API-Schlüssel: Cloudflare KV (verschlüsselt gespeichert)
Abrechnung: Stripe Checkout + Abonnements
Protokoll: Model Context Protocol (MCP)
Sprache: TypeScript

📚 Dokumentation

SETUP.md - Bereitstellungs- & Konfigurationsanleitung
API_USAGE.md - API-Referenz & Beispiele
IMPLEMENTATION_SUMMARY.md - Implementierungsdetails

🔧 Entwicklung

Voraussetzungen

Node.js 18+
npm oder pnpm
Cloudflare-Konto
Stripe-Konto

Lokale Einrichtung

Repo klonen:

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

Abhängigkeiten installieren:

npm install

KV-Namespace erstellen:

npx wrangler kv namespace create API_KEYS

wrangler.jsonc aktualisieren mit KV-Namespace-ID
Geheimnisse festlegen:

npx wrangler secret put STRIPE_SECRET_KEY
npx wrangler secret put STRIPE_WEBHOOK_SECRET

Lokal ausführen:

npm start
# or
npx wrangler dev

Bereitstellen:

npm run deploy
# or
npx wrangler deploy

Vollständige Einrichtungsanleitung: SETUP.md

🧪 Testen

Kostenlose Stufe testen (Keine Authentifizierung)

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
  }'

Authentifizierungsablehnung testen

# 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-Checkout testen

Besuchen Sie http://localhost:8787/pricing
Klicken Sie auf "Subscribe Now"
Verwenden Sie die Testkarte: 4242 4242 4242 4242
Checkout abschließen
Überprüfen Sie, ob der API-Schlüssel auf der Erfolgsseite angezeigt wird

🔐 Sicherheit

API-Schlüssel: Gespeichert in Cloudflare KV (verschlüsselt)
Stripe-Schlüssel: Gespeichert als Worker-Geheimnisse (verschlüsselt)
Webhook-Validierung: Signaturprüfung (für MVP vereinfacht)
Schlüsselwiderruf: Inaktive Schlüssel werden bei Abonnementkündigung markiert
Audit-Trail: Schlüssel werden nicht gelöscht, nur als inaktiv markiert

🚦 Status & Überwachung

Homepage: https://ground-truth-mcp.anish632.workers.dev
Statistiken: https://ground-truth-mcp.anish632.workers.dev/stats
Stripe-Dashboard: https://dashboard.stripe.com
Cloudflare-Dashboard: https://dash.cloudflare.com

📊 Architektur

┌─────────────┐
│   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)  │ │
│                   └───────────────┘ │
└─────────────────────────────────────┘

🤝 Mitwirken

Derzeit werden keine externen Beiträge akzeptiert (privates Projekt), aber Sie können es gerne für Ihren eigenen Gebrauch forken.

📜 Lizenz

MIT-Lizenz - siehe LICENSE-Datei für Details

🆘 Support

E-Mail: anishdasmail@gmail.com
Probleme: https://github.com/anish632/ground-truth-mcp/issues
Twitter: @anish632

🎯 Anwendungsfälle

Für KI-Agenten

Marktforschung validieren, bevor Ergebnisse präsentiert werden
Behauptungen anhand von Live-Quellen faktenprüfen
Wettbewerber mit echten Daten vergleichen
Hypothesen mit strukturierter Verifizierung testen

Für Entwickler

APIs vor der Empfehlung vorab validieren
Preise ohne manuelles Web-Scraping prüfen
Paketanzahlen für Marktgrößenbestimmung schätzen
Automatisierte Faktenprüfung in CI/CD

Für Forscher

Behauptungen mit Live-Daten abgleichen
Paketversionen im Zeitverlauf verfolgen
Preisänderungen überwachen
Akademische Hypothesen validieren

🏆 Was macht Ground Truth anders?

✅ Live-Daten: Keine veralteten Datenbanken, alle Ergebnisse stammen aus Echtzeit-Abrufen ✅ Caching: 5-Minuten-Cache für Leistung, ohne die Aktualität zu opfern ✅ MCP-nativ: Von Anfang an für KI-Agenten entwickelt ✅ Edge Computing: Schnelle Antworten aus dem globalen Netzwerk von Cloudflare ✅ Kostenlose Stufe: Keine Kreditkarte erforderlich zum Ausprobieren ✅ Transparente Preise: 9 $/Monat, unbegrenzte Nutzung, keine versteckten Gebühren ✅ x402-Fallback: Pay-per-Call mit Krypto, wenn Sie kein Abonnement wünschen

📈 Roadmap

[x] Kern-Faktenprüfungstools
[x] Stripe-Abrechnungsintegration
[x] API-Schlüssel-Authentifizierung
[x] Kostenlose Stufe (check_endpoint)
[x] Webhook-Verarbeitung für Abonnements
[ ] Nutzungsanalyse-Dashboard
[ ] E-Mail-Benachrichtigungen
[ ] Team-Konten
[ ] Enterprise-Stufe
[ ] Benutzerdefinierte Integrationen

🙏 Danksagungen

Erstellt mit MCP SDK
Unterstützt durch Cloudflare Workers
Zahlungen durch Stripe
x402-Integration durch @x402

Mit ❤️ erstellt von Anish Das

Zuletzt aktualisiert: 20. März 2026

ground-truth-mcp