Ground Truth MCP

Name: ground-truth-mcp
Author: anish632

Позвольте ИИ-агентам проверять свои собственные утверждения с помощью реальных, актуальных данных из интернета.

MCP Cloudflare Workers Stripe

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

🎯 Что такое Ground Truth?

Ground Truth — это 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`	💳 Pro	Подсчет пакетов в npm/PyPI для оценки размера рынка
`check_pricing`	💳 Pro	Извлечение цен с любого веб-сайта
`compare_competitors`	💳 Pro	Сравнение пакетов услуг
`verify_claim`	💳 Pro	Сверка утверждений с актуальными источниками
`test_hypothesis`	💳 Pro	Автоматизированная проверка фактов с помощью структурированных тестов

Полная документация API: API_USAGE.md

💰 Цены

Бесплатный уровень

check_endpoint - Бесплатно навсегда

Профессиональный уровень - $9/мес

Все 5 премиум-инструментов - Безлимитное использование
5-минутное кэширование - Быстрые ответы
99.9% SLA доступности
Отмена в любое время - Без лишних вопросов

Подписаться сейчас →

🏗️ Технологический стек

Среда выполнения: Cloudflare Workers (edge computing)
Хранилище: 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 с ID пространства имен KV
Установите секреты:

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 (зашифрованы)
Валидация вебхуков: Проверка подписи (упрощено для 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 - подробности см. в файле LICENSE

🆘 Поддержка

Email: anishdasmail@gmail.com
Проблемы: https://github.com/anish632/ground-truth-mcp/issues
Twitter: @anish632

🎯 Варианты использования

Для ИИ-агентов

Проверка результатов исследования рынка перед представлением выводов
Проверка фактов по актуальным источникам
Сравнение конкурентов с использованием реальных данных
Тестирование гипотез со структурированной проверкой

Для разработчиков

Предварительная проверка API перед рекомендацией
Проверка цен без ручного парсинга веб-сайтов
Оценка количества пакетов для анализа рынка
Автоматизированная проверка фактов в CI/CD

Для исследователей

Сверка утверждений с актуальными данными
Отслеживание версий пакетов с течением времени
Мониторинг изменений цен
Проверка академических гипотез

🏆 Что отличает Ground Truth?

✅ Актуальные данные: Никаких устаревших баз данных, все результаты получены в реальном времени ✅ Кэширование: 5-минутный кэш для производительности без потери свежести данных ✅ MCP Native: Создан для ИИ-агентов с первого дня ✅ Edge Computing: Быстрые ответы из глобальной сети Cloudflare ✅ Бесплатный уровень: Не требуется кредитная карта для тестирования ✅ Прозрачное ценообразование: $9/мес, безлимитное использование, никаких скрытых платежей ✅ x402 Fallback: Оплата за вызов криптовалютой, если вы не хотите подписку

📈 Дорожная карта

[x] Основные инструменты проверки фактов
[x] Интеграция биллинга Stripe
[x] Аутентификация по API-ключу
[x] Бесплатный уровень (check_endpoint)
[x] Обработка вебхуков для подписок
[ ] Панель аналитики использования
[ ] Email-уведомления
[ ] Командные аккаунты
[ ] Корпоративный уровень
[ ] Пользовательские интеграции

🙏 Благодарности

Создано с помощью MCP SDK
Работает на Cloudflare Workers
Платежи через Stripe
Интеграция x402 от @x402

Сделано с ❤️ Анишем Дасом

Последнее обновление: 20 марта 2026 г.

ground-truth-mcp