Vantage Movers MCP

远程 Model Context Protocol 服务器，让智能体能够在一个地方使用 Granot / Vantage 后端并查询 MongoDB Atlas。

托管在 Vercel 上，使用 mcp-handler v2 和 Next.js。这是当前 Vercel 支持的方案：Streamable HTTP 加上 2026-07-28 版的 MCP 规范，无需 Redis，也不需要常驻的 stdio 进程。

为什么选择这个库

Related MCP server: MongoDB MCP Server

必需的 MCP 配置

VANTAGE_API_SECRET 在客户端配置中是必需的。服务器在调用 https://vantage-movers-main-server.vercel.app 时，会将该值放入 x-api-secret 请求头。

Cursor / Claude 风格的 Streamable HTTP：

{
  "mcpServers": {
    "vantage-movers": {
      "url": "https://vantage-movers-mcp.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer <VANTAGE_API_SECRET>"
      }
    }
  }
}

如果客户端更倾向于使用 Vantage 的请求头名称，x-api-secret 也同样会被接受：

{
  "mcpServers": {
    "vantage-movers": {
      "url": "https://vantage-movers-mcp.vercel.app/api/mcp",
      "headers": {
        "x-api-secret": "<VANTAGE_API_SECRET>"
      }
    }
  }
}

对于远程 URL，不要把密钥放在 env 中。HTTP MCP 客户端只会发送 headers。env 是给本地 stdio 服务器使用的。

生产环境还会在 Vercel 项目上存储 VANTAGE_API_SECRET，因此公共 URL 无法用伪造的 token 访问 Mongo。客户端配置的值必须与之匹配。

MongoDB

官方 MongoDB MCP 服务器采用 stdio 方式运行。本部署在进程内保留了一个专用的 Mongo 接口：

• mongo_list_databases

• mongo_list_collections

• mongo_collection_schema

• mongo_collection_indexes

• mongo_find

• mongo_aggregate

• mongo_count

• mongo_db_stats

只读。$out 和 $merge 会被拒绝。默认数据库为 vantagemovers（当 TEST_MODE=true 时为 testvantagemovers）。

对 Form / Call Lead 的写入，请使用 lead 工具。对 Mongo 的原始写操作会跳过 Sheet Sync 和 CRM 提交。

首批工具

后续批次：Granot 同步、Owner Registry 条目、预订用例。

本地

pnpm install
cp .env.example .env.local
# fill VANTAGE_API_SECRET and MONGO_URI
pnpm test
pnpm typecheck
pnpm dev

本地 MCP URL：http://localhost:3100/api/mcp

环境