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 中添加其选项卡解析器。