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는 AI 에이전트에게 사실 확인 및 시장 조사 도구를 제공하는 MCP 서버입니다. 환각이나 추측 대신, 에이전트는 다음을 수행할 수 있습니다:

✅ 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

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 결제 테스트

http://localhost:8787/pricing 방문
"Subscribe Now" 클릭
테스트 카드 사용: 4242 4242 4242 4242
결제 완료
성공 페이지에 표시된 API 키 확인

🔐 보안

API 키: Cloudflare KV에 저장 (저장 시 암호화)
Stripe 키: Worker 비밀로 저장 (암호화)
웹훅 검증: 서명 검증 (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
트위터: @anish632

🎯 사용 사례

AI 에이전트용

결과를 제시하기 전 시장 조사 검증
실시간 소스를 기반으로 주장 사실 확인
실제 데이터로 경쟁사 비교
구조화된 검증으로 가설 테스트

개발자용

API 추천 전 사전 검증
수동 웹 스크래핑 없이 가격 확인
시장 규모 측정을 위한 패키지 수 추정
CI/CD에서의 자동 사실 확인

연구원용

실시간 데이터로 주장 교차 검증
시간 경과에 따른 패키지 버전 추적
가격 변동 모니터링
학술적 가설 검증

🏆 Ground Truth가 차별화되는 점은 무엇인가요?

✅ 실시간 데이터: 오래된 데이터베이스가 아닌, 실시간 가져오기를 통한 모든 결과 ✅ 캐싱: 신선함을 희생하지 않으면서 성능을 위한 5분 캐시 ✅ MCP 네이티브: 처음부터 AI 에이전트를 위해 구축됨 ✅ 엣지 컴퓨팅: Cloudflare의 글로벌 네트워크를 통한 빠른 응답 ✅ 무료 티어: 체험을 위해 신용카드가 필요 없음 ✅ 투명한 가격: 월 $9, 무제한 사용, 숨겨진 수수료 없음 ✅ x402 폴백: 구독을 원하지 않는 경우 암호화폐로 호출당 결제

📈 로드맵

[x] 핵심 사실 확인 도구
[x] Stripe 결제 통합
[x] API 키 인증
[x] 무료 티어 (check_endpoint)
[x] 구독을 위한 웹훅 처리
[ ] 사용량 분석 대시보드
[ ] 이메일 알림
[ ] 팀 계정
[ ] 엔터프라이즈 티어
[ ] 사용자 지정 통합

🙏 감사의 말

MCP SDK로 구축됨
Cloudflare Workers 기반
Stripe 결제
@x402의 x402 통합

Anish Das가 ❤️를 담아 제작

마지막 업데이트: 2026년 3월 20일

ground-truth-mcp