Antarestar Live — MCP Server (für Hermes)

MCP read-only, der Hermes (AI-Agent) Zugriff auf die Daten des Antarestar Live Dashboards gibt. Er zieht aus dem gleichen Google Sheet wie das Dashboard, mit identischer Spaltenzuordnung – daher sind die von Hermes gelesenen Zahlen gleich den Zahlen, die im Dashboard angezeigt werden.

Verfügbare Tools

Alle Daten im Format YYYY-MM-DD. Read-only – Hermes kann keine Daten ändern.

Related MCP server: SEOAnalytics Read MCP

1. Lokales Setup & Test

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

Testen als MCP stdio (für lokales Hermes / MCP Inspector):

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

2. Deployment auf Vercel (Remote HTTP – für Hermes Cloud)

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

Dann in Vercel → Project → Settings → Environment Variables setzen:

• MCP_API_KEY = langer geheimer Schlüssel (Hermes muss diesen senden)

• (optional) SHEET_ID, falls die Tabelle überschrieben werden soll

Der MCP-Endpunkt:

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

3. Hermes verbinden

Hermes (MCP-Client) verbindet sich über Streamable HTTP mit der obigen URL, mit folgendem Header:

x-api-key: <MCP_API_KEY>

Beispiel für eine MCP-Konfiguration (allgemeines Format des MCP-Clients):

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

Schnellprüfung des Live-Endpunkts (GET):

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

Architektur

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 – Parser & Konvertierung von Zahlen/Daten (aus dem Dashboard portiert).

• src/sheet.ts – Abruf + Parsen + Aggregation (Cache 60 Sekunden pro Instanz).

• src/tools.ts – Definition der 5 MCP-Tools.

• api/mcp.ts – Streamable-HTTP-Endpunkt + API-Key-Authentifizierung (Vercel).

• src/stdio.ts – Lokaler Modus (stdio).

Hinweise

• Read-only: Es gibt keine Schreib-Tools. Sicher.

• Die Daten folgen dem Sheet – sobald das Dashboard/der Importer Daten hinzufügt, wird der MCP automatisch aktualisiert (Cache 60s).

• Möchten Sie ein Tool hinzufügen (z.B. checkpoint_daily_live, daily_report_host)? Fügen Sie es einfach in src/tools.ts und den Tab-Parser in src/sheet.ts hinzu.