Antarestar Live — MCP-сервер (для Hermes)

MCP только для чтения, который предоставляет Hermes (AI-агенту) доступ к данным Antarestar Live Dashboard. Загружает данные из того же Google Sheet, что и панель управления, используя идентичное отображение столбцов — поэтому цифры, которые видит Hermes, совпадают с цифрами на панели.

Доступные инструменты

Все даты в формате YYYY-MM-DD. Только для чтения — Hermes не может изменять данные.

Related MCP server: SEOAnalytics Read MCP

1. Локальная настройка и тестирование

npm install
npm run smoke      # tes lapisan data ke sheet live (harus keluar angka)
npm run typecheck  # cek TypeScript

Тестирование как MCP stdio (для локального Hermes / MCP Inspector):

npx @modelcontextprotocol/inspector npx tsx src/stdio.ts

2. Развертывание на Vercel (удаленный HTTP — для облачного Hermes)

npm i -g vercel      # kalau belum
vercel               # deploy (ikutin promptnya)
vercel --prod        # deploy production

Затем в Vercel → Project → Settings → Environment Variables установите:

• MCP_API_KEY = длинный секретный ключ (Hermes обязан его отправлять)

• (опционально) SHEET_ID если нужно переопределить таблицу

Конечная точка MCP:

https://<project>.vercel.app/api/mcp      (atau /mcp)

3. Подключение Hermes

Hermes (MCP-клиент) подключается через Streamable HTTP по указанному выше URL с заголовком:

x-api-key: <MCP_API_KEY>

Пример конфигурации MCP (общий формат клиента MCP):

{
  "mcpServers": {
    "antarestar-live": {
      "url": "https://<project>.vercel.app/api/mcp",
      "headers": { "x-api-key": "<MCP_API_KEY>" }
    }
  }
}

Быстрая проверка работоспособности конечной точки (GET):

curl -H "x-api-key: <MCP_API_KEY>" https://<project>.vercel.app/api/mcp

Архитектура

Hermes (AI) ──MCP/HTTP──► api/mcp.ts ──► src/tools.ts ──► src/sheet.ts ──CSV──► Google Sheet
                          (Vercel)        (5 tools)      (parse + calcO)        (RAW Shopee/Tiktok, Data)

• src/csv.ts — парсер и преобразование чисел/дат (перенесено из панели).

• src/sheet.ts — загрузка + парсинг + агрегация (кэш 60 секунд на экземпляр).

• src/tools.ts — определение 5 инструментов MCP.

• api/mcp.ts — конечная точка Streamable HTTP + аутентификация по API-ключу (Vercel).

• src/stdio.ts — локальный режим (stdio).

Заметки

• Только для чтения: нет инструментов для записи. Безопасно.

• Данные следуют за таблицей — как только панель или импортер добавляют данные, MCP автоматически обновляется (кэш 60 с).

• Хотите добавить инструмент (например, checkpoint_daily_live, daily_report_host)? Просто добавьте его в src/tools.ts и парсер соответствующей вкладки в src/sheet.ts.