lead-stampede

Lead Stampede MCP 服务

为 Lead Stampede Agent Cards 提供支持的在线后端。通过 HTTP 将 SMB 商业数据作为 AI Agent 可调用的工具提供。

这是什么

一个实现了四个 MCP 工具的 Express 服务：

工具	返回内容
get_business_profile	名称、描述、行业、服务区域、联系信息
get_services	服务列表 + 价格摘要
get_availability	营业时间 + 预约 URL（或电话/电子邮件备用联系方式）
get_reviews	评论数量、平均评分、摘要

每个请求都通过 X-Agency-API-Key 请求头进行身份验证，该请求头映射到 Supabase agencies 表中的一行。客户端仅限访问所属的机构，因此一个机构永远无法读取其他机构的数据。

设置

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 secret 中获取
• 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. 部署完成后，Railway 会提供一个公开 URL，例如 mcp-production.up.railway.app。
7. 通过 Railway → Settings → Domains，将自定义子域名（例如 mcp.leadstampede.io）指向该地址。

架构

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

后续步骤

• 构建 Cloudflare Worker，在 agentcards.leadstampede.io/{slug} 提供 Agent Cards。
• 构建入驻表单，用于在 Supabase 中创建 clients 行。
• 构建机构门户仪表板。