Skip to main content
Glama
Dianping MCP Server

Dianping MCP Server

by qianwj

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:检查浏览器是否可用、是否需要登录或安全验证。

Related MCP server: tieba-mcp

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 规则和适用法律。

Available Tools

3 tools
check_session检查大众点评会话A
Read-only

检查本地浏览器、登录状态及是否需要完成安全验证。

Inputs: no named parameters.

get_place_details读取大众点评店铺详情A
Read-only

根据搜索结果中的店铺 ID 或 URL 读取地址、电话、营业时间、评分及精选评论。

Inputs: shop (required), reviewLimit.

search_places搜索大众点评商户A
Read-only

按城市和关键词搜索大众点评上的餐厅、景点、酒店或其他本地商户。

Inputs: keyword (required), city, page, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    The three tools have clearly distinct purposes: searching for places, retrieving detailed info about a specific place, and checking session/authentication status. No overlap or ambiguity between them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (search_places, get_place_details, check_session), making the naming predictable and easy to understand.

    Tool Count4/5

    With 3 tools, the server is concise but covers the core functionality of searching and retrieving details for a local services platform. The inclusion of a session-check tool is practical, and the count feels appropriate for the scope.

    Completeness4/5

    The tool surface covers the essential read operations—search and detail retrieval—along with session verification. For a read-oriented API, this is reasonably complete. Minor gaps like listing categories or handling pagination could exist but are not critical.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables reading public Baidu Tieba content through a persistent real-browser session, supporting forum searches, post details, and user public post lists with optional login-state injection.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only, local browser-based access to logged-in sessions on Xianyu, Taobao/Tmall, JD, and Pinduoduo for product search, detail inspection, link building/parsing, and cookie status checks, without chat, cart, ordering, or payment actions.
      MIT