Dianping MCP Server

这是一个通过本地浏览器登录会话搜索大众点评内容的 MCP server。大众点评的桌面端和移动端搜索会对匿名请求触发登录/安全验证，因此本项目不使用未经授权的接口，也不尝试绕过验证码或反爬机制；服务使用 Playwright 驱动本机 Chrome，并复用独立的持久化 profile。

快速开始

要求 Node.js 20+，并安装 Chrome、Edge 或 Chromium：

npm install
npm run login

登录命令会打开浏览器。请完成大众点评登录和安全验证，然后回到终端按 Ctrl+C 退出。登录资料默认保存到 ~/.dianping-mcp/browser-profile。之后启动 MCP server：

npm run build
npm start

MCP 客户端使用 stdio 连接，提供三个工具：

• search_places：按城市、关键词、页码搜索商户，返回名称、评分、评价数、人均、地址和店铺 URL。
• get_place_details：按店铺 ID 或搜索结果里的 URL 获取店铺信息及精选评论。
• check_session：检查浏览器是否可用、是否需要登录或安全验证。

MCP 客户端配置

把下面的命令配置到支持 stdio MCP 的客户端，路径替换成仓库的绝对路径：

{
  "mcpServers": {
    "dianping": {
      "command": "npm",
      "args": ["--prefix", "/绝对路径/dp-mcp", "start"],
      "env": {
        "DP_CITY": "上海"
      }
    }
  }
}

也可以直接使用构建后的 dist/index.js：

{
  "command": "node",
  "args": ["/绝对路径/dp-mcp/dist/index.js"],
  "env": { "DP_CITY": "上海" }
}

配置项

变量	默认值	作用
DP_PROFILE_DIR	~/.dianping-mcp/browser-profile	浏览器登录资料目录
DP_BROWSER_EXECUTABLE_PATH	自动探测	Chrome/Edge/Chromium 可执行文件
DP_CITY	上海	search_places 未传城市时的默认城市
DP_HEADLESS	true	MCP 搜索是否无头运行；登录请使用 npm run login
DP_MIN_INTERVAL_MS	1500	两次页面请求的最小间隔
DP_CACHE_TTL_MS	300000	搜索和详情的内存缓存时间
DP_NAVIGATION_TIMEOUT_MS	25000	页面导航和选择器超时

当前内置常用城市包括上海、北京、杭州、广州、南京、苏州、深圳、成都、重庆、天津、宁波、扬州、无锡、福州、厦门、武汉、西安、沈阳、大连、长沙、青岛和济南；其他城市可传大众点评城市 ID。

开发与验证

npm test
npm run check
npm run build

页面结构或安全策略变化时，服务会返回明确的解析/验证错误。请降低调用频率，并遵守大众点评的服务条款、robots 规则和适用法律。