lead-stampede

Lead Stampede MCP Server

Lead Stampede Agent Cards を支えるライブバックエンドです。SMB のビジネスデータを、AI エージェントが HTTP 経由で呼び出せるツールとして公開します。

これは何か

4 つの MCP ツールを実装した Express サーバーです。

ツール	返される内容
get_business_profile	名前、説明、業種、サービス提供地域、連絡先情報
get_services	サービス一覧＋料金の概要
get_availability	営業時間＋予約 URL（または電話／メールによる代替手段）
get_reviews	レビュー件数、平均評価、概要

各リクエストは、Supabase の agencies テーブルの行に対応する X-Agency-API-Key ヘッダーで認証されます。クライアントはそれぞれのエージェンシーのデータのみにアクセスできるため、あるエージェンシーが別のエージェンシーのデータを読み取ることはできません。

セットアップ

1. インストール

npm install

2. 環境を設定する

cp .env.example .env

次に .env を編集して、以下を入力します。

• SUPABASE_URL — プロジェクトの URL（例：https://xlhxnlhxeprtzwbyepza.supabase.co）
• SUPABASE_SERVICE_ROLE_KEY — Supabase → Project Settings → API → service_role シークレットから取得します
• PORT — デフォルトは 3000 です

.env を git にコミットしないでください。 すでに .gitignore に登録されています。

3. ローカルで実行する

npm run dev

次のように表示されます。

Lead Stampede MCP server listening on port 3000

動作をテストする

ヘルスチェック（認証不要）

curl http://localhost:3000/health
# → {"status":"ok","timestamp":"..."}

利用可能なツールを一覧表示する（認証が必要）

curl -H "X-Agency-API-Key: YOUR_AGENCY_API_KEY" \
  http://localhost:3000/mcp/tools

ツールを呼び出す

curl -X POST \
  -H "X-Agency-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments":{"client_slug":"grandinetti-molinar-law"}}' \
  http://localhost:3000/mcp/tools/get_business_profile

期待されるレスポンス：

{
  "tool": "get_business_profile",
  "result": {
    "business_name": "Grandinetti & Molinar Law",
    "description": "Austin-based law firm founded in 2002...",
    "industry": "legal",
    ...
  },
  "response_ms": 42
}

Railway へのデプロイ

1. このフォルダーを新しい GitHub リポジトリにプッシュします。
2. Railway で、New Project → Deploy from GitHub repo を選択します。
3. このリポジトリを選択します。
4. Variables で、以下を追加します。
   • SUPABASE_URL
   • SUPABASE_SERVICE_ROLE_KEY
5. Railway が Node.js を自動検出し、依存関係をインストールして、npm start を実行します。
6. デプロイが完了すると、mcp-production.up.railway.app のような公開 URL が Railway から提供されます。
7. Railway → Settings → Domains から、カスタムサブドメイン（例：mcp.leadstampede.io）をこの URL に向けます。

アーキテクチャ

AI agent  →  POST /mcp/tools/:name  →  auth.js → tools.js → supabase.js
                                         ↓
                                   analytics.js (fire-and-forget)
                                         ↓
                                   mcp_tool_calls table

次のステップ

• agentcards.leadstampede.io/{slug} で Agent Cards を提供する Cloudflare Worker を構築します。
• Supabase の clients 行にデータを登録するオンボーディングフォームを構築します。
• エージェンシーポータルのダッシュボードを構築します。