Ground Truth MCP

Name: ground-truth-mcp
Author: anish632

AIエージェントが、Web上のリアルタイムデータを使用して自身の主張を検証できるようにします。

MCP Cloudflare Workers Stripe

ライブURL: https://ground-truth-mcp.anish632.workers.dev

🎯 Ground Truthとは？

Ground Truthは、AIエージェントにファクトチェックおよび市場調査ツールを提供するMCPサーバーです。AIがハルシネーション（幻覚）を起こしたり推測したりする代わりに、以下のようなことが可能になります：

✅ APIエンドポイントが実際に存在するか確認する
📊 実際の市場の競合他社をカウントする
💰 Webサイトから実際の価格を抽出する
🔍 パッケージを並べて比較する
🧪 主張をライブソースと照らし合わせて検証する
⚗️ 構造化されたテストで仮説を検証する

すべての結果はリアルタイムで取得されたライブデータに基づいており、パフォーマンス向上のため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`	💳 プロ	Webサイトから価格を抽出
`compare_competitors`	💳 プロ	パッケージの並列比較
`verify_claim`	💳 プロ	主張をライブソースと照らし合わせて検証
`test_hypothesis`	💳 プロ	構造化テストによる自動ファクトチェック

完全なAPIドキュメント: API_USAGE.md

💰 料金

無料ティア

check_endpoint - 無制限（永続）

プロティア - 月額9ドル

5つのプレミアムツールすべて - 無制限利用
5分間のキャッシュ - 高速なレスポンス
99.9%の稼働率SLA
いつでもキャンセル可能 - 理由を問わず

今すぐ登録 →

🏗️ 技術スタック

ランタイム: Cloudflare Workers (エッジコンピューティング)
ストレージ: Durable Objects + SQLite (キャッシュ + 利用ログ)
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

wrangler.jsoncをKV名前空間IDで更新
シークレットを設定:

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 Checkoutのテスト

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
Issue: https://github.com/anish632/ground-truth-mcp/issues
Twitter: @anish632

🎯 ユースケース

AIエージェント向け

調査結果を提示する前に市場調査を検証
ライブソースと照らし合わせて主張をファクトチェック
実際のデータで競合他社を比較
構造化された検証で仮説をテスト

開発者向け

推奨する前にAPIを事前検証
手動のWebスクレイピングなしで価格を確認
市場規模測定のためにパッケージ数を推定
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統合

Made with ❤️ by Anish Das

最終更新日: 2026年3月20日

ground-truth-mcp