Antarestar Live — Servidor MCP (para Hermes)

MCP de solo lectura que le da a Hermes (agente de IA) acceso a los datos del Panel de control en vivo de Antarestar. Obtiene datos de la misma hoja de Google que el panel, usando un mapeo de columnas idéntico, por lo que los números que lee Hermes son los mismos que aparecen en el panel.

Herramientas disponibles

Todas las fechas en formato YYYY-MM-DD. Solo lectura — Hermes no puede modificar datos.

Related MCP server: SEOAnalytics Read MCP

1. Configuración local y pruebas

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

Prueba como MCP stdio (para Hermes local / MCP Inspector):

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

2. Desplegar en Vercel (HTTP remoto — para Hermes cloud)

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

Luego en Vercel → Proyecto → Configuración → Variables de entorno, establecer:

• MCP_API_KEY = clave secreta larga (Hermes debe enviar esto)

• (opcional) SHEET_ID si se quiere sobrescribir la hoja de cálculo

El endpoint MCP es:

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

3. Conectar Hermes

Hermes (cliente MCP) se conecta vía Streamable HTTP a la URL anterior, con el encabezado:

x-api-key: <MCP_API_KEY>

Ejemplo de configuración MCP (formato común de cliente MCP):

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

Verificación rápida del endpoint activo (GET):

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

Arquitectura

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 — analizador y conversión de números/fechas (portado del panel).

• src/sheet.ts — obtención + análisis + agregación (caché de 60 segundos por instancia).

• src/tools.ts — definición de 5 herramientas MCP.

• api/mcp.ts — endpoint Streamable HTTP + autenticación con clave API (Vercel).

• src/stdio.ts — modo local (stdio).

Notas

• Solo lectura: no hay herramientas de escritura. Seguro.

• Los datos siguen la hoja — tan pronto como el panel/importador añada datos, el MCP se actualiza automáticamente (caché de 60s).

• ¿Quieres añadir una herramienta (p. ej. checkpoint_daily_live, daily_report_host)? Solo hay que agregarla en src/tools.ts + el analizador de su pestaña en src/sheet.ts.