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にタブのパーサーを追加するだけです。