Dianping MCP Server

로컬 브라우저 로그인 세션을 통해 다이앤핑(大众点评) 콘텐츠를 검색하는 MCP 서버입니다. 다이앤핑의 데스크톱 및 모바일 검색은 익명 요청에 대해 로그인/보안 인증을 트리거하므로, 이 프로젝트는 승인되지 않은 인터페이스를 사용하지 않으며 캡차나 안티크롤링 메커니즘을 우회하려 하지 않습니다. 서비스는 Playwright를 사용하여 로컬 Chrome을 구동하고 독립적인 영구 프로필을 재사용합니다.

빠른 시작

Node.js 20+가 필요하며 Chrome, Edge 또는 Chromium이 설치되어 있어야 합니다:

npm install
npm run login

로그인 명령은 브라우저를 엽니다. 다이앤핑 로그인 및 보안 인증을 완료한 후 터미널로 돌아와 Ctrl+C를 눌러 종료하세요. 로그인 데이터는 기본적으로 ~/.dianping-mcp/browser-profile에 저장됩니다. 그런 다음 MCP 서버를 시작합니다:

npm run build
npm start

MCP 클라이언트는 stdio로 연결되며 세 가지 도구를 제공합니다:

• search_places: 도시, 키워드, 페이지 번호로 상점을 검색하여 이름, 평점, 리뷰 수, 1인당 가격, 주소 및 상점 URL을 반환합니다.

• get_place_details: 상점 ID 또는 검색 결과의 URL을 사용하여 상점 정보 및 추천 리뷰를 가져옵니다.

• check_session: 브라우저 사용 가능 여부, 로그인 또는 보안 인증 필요 여부를 확인합니다.

Related MCP server: dots-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": "上海" }
}

구성 옵션

현재 내장된 일반 도시는 상하이, 베이징, 항저우, 광저우, 난징, 쑤저우, 선전, 청두, 충칭, 톈진, 닝보, 양저우, 우시, 푸저우, 샤먼, 우한, 시안, 선양, 다롄, 창사, 칭다오, 지난입니다. 다른 도시는 다이앤핑 도시 ID를 전달할 수 있습니다.

개발 및 검증

npm test
npm run check
npm run build

페이지 구조나 보안 정책이 변경되면 서비스는 명확한 구문 분석/인증 오류를 반환합니다. 호출 빈도를 낮추고 다이앤핑의 서비스 약관, robots 규칙 및 관련 법률을 준수하세요.