Dianping MCP Server

This is an MCP server that searches Dianping content through a local browser login session. Both the desktop and mobile search endpoints of Dianping trigger login/security verification for anonymous requests, so this project does not use unauthorized interfaces, nor does it attempt to bypass CAPTCHAs or anti-scraping mechanisms; the service uses Playwright to drive the local Chrome browser and reuses an independent persistent profile.

Quick Start

Requires Node.js 20+ and Chrome, Edge, or Chromium installed:

npm install
npm run login

The login command will open the browser. Please complete the Dianping login and security verification, then return to the terminal and press Ctrl+C to exit. The login data is saved by default to ~/.dianping-mcp/browser-profile. After that, start the MCP server:

npm run build
npm start

The MCP client connects via stdio and provides three tools:

• search_places: Search for merchants by city, keyword, and page number, returning name, rating, review count, average spending, address, and shop URL.

• get_place_details: Get shop details and featured reviews by shop ID or the URL from search results.

• check_session: Check if the browser is available, and whether login or security verification is needed.

Related MCP server: dots-mcp

MCP Client Configuration

Configure the following command in a client that supports stdio MCP, replacing the path with the absolute path of the repository:

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

Alternatively, you can directly use the built dist/index.js:

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

Configuration Options

Currently built-in common cities include Shanghai, Beijing, Hangzhou, Guangzhou, Nanjing, Suzhou, Shenzhen, Chengdu, Chongqing, Tianjin, Ningbo, Yangzhou, Wuxi, Fuzhou, Xiamen, Wuhan, Xi'an, Shenyang, Dalian, Changsha, Qingdao, and Jinan; other cities can be passed via Dianping city ID.

Development and Verification

npm test
npm run check
npm run build

When page structure or security policies change, the service will return clear parsing/verification errors. Please reduce call frequency and comply with Dianping's Terms of Service, robots rules, and applicable laws.