Local Business Data MCP Server

English | 简体中文 | 繁體中文

用于访问 Local Business Data API 的 MCP 服务器。

🚀 使用 EMCP 平台快速体验

EMCP 是一个强大的 MCP 服务器管理平台，让您无需手动配置即可快速使用各种 MCP 服务器！

快速开始：

1. 🌐 访问 EMCP 平台
2. 📝 注册并登录账号
3. 🎯 进入 MCP 广场，浏览所有可用的 MCP 服务器
4. 🔍 搜索或找到本服务器（bach-local_business_data）
5. 🎉 点击 "安装 MCP" 按钮
6. ✅ 完成！即可在您的应用中使用

EMCP 平台优势：

• ✨ 零配置：无需手动编辑配置文件
• 🎨 可视化管理：图形界面轻松管理所有 MCP 服务器
• 🔐 安全可靠：统一管理 API 密钥和认证信息
• 🚀 一键安装：MCP 广场提供丰富的服务器选择
• 📊 使用统计：实时查看服务调用情况

立即访问 EMCP 平台 开始您的 MCP 之旅！

---

简介

这是一个 MCP 服务器，用于访问 Local Business Data API。

• PyPI 包名: bach-local_business_data
• 版本: 1.0.0
• 传输协议: stdio

安装

从 PyPI 安装:

pip install bach-local_business_data

从源码安装:

pip install -e .

运行

方式 1: 使用 uvx（推荐，无需安装）

# 运行（uvx 会自动安装并运行）
uvx --from bach-local_business_data bach_local_business_data

# 或指定版本
uvx --from bach-local_business_data@latest bach_local_business_data

方式 2: 直接运行（开发模式）

python server.py

方式 3: 安装后作为命令运行

# 安装
pip install bach-local_business_data

# 运行（命令名使用下划线）
bach_local_business_data

配置

API 认证

此 API 需要认证。请设置环境变量:

export API_KEY="your_api_key_here"

环境变量

变量名	说明	必需
API_KEY	API 密钥	是
PORT	不适用	否
HOST	不适用	否

在 Cursor 中使用

编辑 Cursor MCP 配置文件 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bach-local_business_data": {
      "command": "uvx",
      "args": ["--from", "bach-local_business_data", "bach_local_business_data"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件 claude_desktop_config.json:

{
  "mcpServers": {
    "bach-local_business_data": {
      "command": "uvx",
      "args": ["--from", "bach-local_business_data", "bach_local_business_data"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

此服务器提供以下工具:

business_review_details

Get the details of a specific review by Google Id / Business Id or Google Place Id and Review Author Id.

端点: GET /review-details

参数:

• business_id (string) 必需: The Business Id of the business for which the review belongs. Accepts google_id / business_id or place_id. Examples: 0x880fd393d427a591:0x8cba02d713a995ed ChIJkaUn1JPTD4gR7ZWpE9cCuow

• review_author_id (string) 必需: Review author id (i.e review author_id field). In addition, batching of up to 20 Review Author Ids is supported in a single request using a comma separated list (e.g. review_author_id=id1,id2).

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

---

search_in_area

Search businesses in a specific geographic area defined by a center coordinate point and zoom level. To see it in action, make a query on Google Maps, wait for the results to show, move the map or change the zoom and click \

端点: GET /search-in-area

参数:

• query (string) 必需: Search query / keyword

• lat (number) 必需: Latitude of the center coordinate point of the area to search in.

• lng (number) 必需: Longitude of the center coordinate point of the area to search in.

• zoom (string) 必需: Zoom level on which to make the search (the search area / viewport is determined by lat, lng and zoom on a 1000x1000 screen).

• limit (number): Maximum number of businesses to return. Default: 20 Allowed values: 1-500

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• subtypes (string): Find businesses with specific subtypes, specified as a comma separated list of types (business categories). For the complete list of types, see https://daltonluka.com/blog/google-my-business-categories. Examples: Plumber,Carpenter,Electrician Night club,Dance club,Bar,Pub

• extract_emails_and_contacts (string): Example value:

• fields (string): A comma separated list of business fields to include in the response (field projection). By default all fields are returned. Example: business_id,type,phone_number,full_address

• X-User-Agent (string): Device type for the search. Default desktop.

---

autocomplete

Returns place/address, business and query predictions for text-based geographic queries.

端点: GET /autocomplete

参数:

• query (string) 必需: Search query

• region (string): Return results biased to a particular region. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code). Default: us

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 . Default: en

• coordinates (string): Geographic coordinates of the location from which the query is applied - recommended to use so that results are biased towards this location. Defaults to some central location in the region (see the region parameter).

---

business_photo_details

Get extra details about a business photo - caption, owner name and avatar, and more information. Supports batching of up to 20 Photo Ids.

端点: GET /photo-details

参数:

• business_id (string) 必需: The Business Id of the business for which the photo belongs. Accepts google_id / business_id or place_id. Examples: 0x880fd393d427a591:0x8cba02d713a995ed ChIJkaUn1JPTD4gR7ZWpE9cCuow

• photo_id (string) 必需: Photo Id of the photo to fetch. In addition, batching of up to 20 Photo Ids is supported in a single request using a comma separated list (e.g. photo_id=id1,id2).

---

business_posts

Get all / paginate Business Owner Posts (\

端点: GET /business-posts

参数:

• business_id (string) 必需: Unique Business Id. Accepts google_id / business_id or place_id. Examples: 0x880fd393d427a591:0x8cba02d713a995ed ChIJkaUn1JPTD4gR7ZWpE9cCuow

• cursor (string): Specify the cursor obtained from the previous request to get the next of result page (use for pagination).

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

---

reverse_geocoding

Get the details of a place or address in a specific geographic location by latitude and longitude (reverse geocoding). This endpoint implements the \

端点: GET /reverse-geocoding

参数:

• lat (number) 必需: Example value: 40.6958453

• lng (number) 必需: Example value: -73.9799119

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code). Default: us

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

• fields (string): A comma separated list of business fields to include in the response (field projection). By default all fields are returned. Example: business_id,type,phone_number,full_address

---

search_nearby

Search businesses near by specific geographic coordinates. To see it in action, right click on a specific point in the map on Google Maps and select \

端点: GET /search-nearby

参数:

• query (string) 必需: Search query / keyword Examples: Bars and pubs Plumbers

• lat (number) 必需: Latitude of the geographic coordinates to search near by.

• lng (number) 必需: Longitude of the geographic coordinates to search near by.

• limit (number): Maximum number of businesses to return. Default: 20 Allowed values: 1-500

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• subtypes (string): Find businesses with specific subtypes, specified as a comma separated list of types (business categories). For the complete list of types, see https://daltonluka.com/blog/google-my-business-categories. Examples: Plumber,Carpenter,Electrician Night club,Dance club,Bar,Pub

• extract_emails_and_contacts (string): Example value:

• fields (string): A comma separated list of business fields to include in the response (field projection). By default all fields are returned. Example: business_id,type,phone_number,full_address

• X-User-Agent (string): Device type for the search. Default desktop.

---

business_photos

Get business photos by Business Id.

端点: GET /business-photos

参数:

• business_id (string) 必需: Unique Business Id. Accepts google_id / business_id or place_id. Examples: 0x880fd393d427a591:0x8cba02d713a995ed ChIJkaUn1JPTD4gR7ZWpE9cCuow

• limit (number): Maximum number of business photos to return. Default: 20 Allowed values: 1-100

• cursor (string): Specify the cursor obtained from the previous request to get the next of result page (use for pagination).

• is_video (string): Example value:

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• fields (string): A comma separated list of review fields to include in the response (field projection). By default all fields are returned. Example: type,photo_url

---

search

Search local businesses on Google Maps with an option to pull emails and social profile links from their website (see the extract_emails_and_contacts parameter below).

端点: GET /search

参数:

• query (string) 必需: Search query / keyword Examples: Plumbers near New-York, USA Bars in 94102, USA

• limit (number): Maximum number of businesses to return. Default: 20 Allowed values: 1-500

• lat (number): Latitude of the coordinates point from which the query is applied - recommended to use so that results are biased towards this location. Defaults to some central location in the region (see the region parameter).

• lng (number): Longitude of the coordinates point from which the query is applied - recommended to use so that results are biased towards this location. Defaults to some central location in the region (see the region parameter).

• zoom (string): Zoom level on which to make the search (the viewport is determined by lat, lng and zoom). Default: 13

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• subtypes (string): Find businesses with specific subtypes, specified as a comma separated list of types (business categories). For the complete list of types, see https://daltonluka.com/blog/google-my-business-categories. Examples: Plumber,Carpenter,Electrician Night club,Dance club,Bar,Pub

• verified (string): Example value:

• business_status (string): Find businesses with specific status, specified as a comma separated list of the following values: OPEN, CLOSED_TEMPORARILY, CLOSED. Examples: OPEN CLOSED_TEMPORARILY,CLOSED

• fields (string): A comma separated list of business fields to include in the response (field projection). By default all fields are returned. Example: business_id,type,phone_number,full_address

• extract_emails_and_contacts (string): Example value:

• X-User-Agent (string): Device type for the search. Default desktop.

---

bulk_search

Search local businesses on Google Maps. Batching of up to 20 queries is supported in a single request.

端点: POST /search

参数:

• X-User-Agent (string): Device type for the search. Default desktop.

---

business_details

Get full business details including emails and social contacts. Supports batching of up to 20 Business Ids.

端点: GET /business-details

参数:

• business_id (string) 必需: Unique Business Id. Accepts google_id / business_id or place_id. Examples: 0x880fd393d427a591:0x8cba02d713a995ed ChIJkaUn1JPTD4gR7ZWpE9cCuow In addition, batching of up to 20 Business Ids is supported in a single request using a comma separated list (e.g. business_id=id1,id2).

• extract_emails_and_contacts (string): Example value:

• extract_share_link (string): Example value:

• fields (string): A comma separated list of business fields to include in the response (field projection). By default all fields are returned. Example: business_id,type,phone_number,full_address

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

• coordinates (string): Geographic coordinates of the location from which the query is applied - recommended to use so that results are biased towards this location. Defaults to some central location in the region (see the region parameter).

---

business_reviews_v2

Get business reviews by Business Id with pagination support.

端点: GET /business-reviews-v2

参数:

• business_id (string) 必需: Unique Business Id. Accepts google_id / business_id or place_id. Examples: 0x880fd393d427a591:0x8cba02d713a995ed ChIJkaUn1JPTD4gR7ZWpE9cCuow

• limit (number): Maximum number of business reviews to return. Default: 20 Allowed values: 1-1000

• cursor (string): The cursor value from the previous response to get the next set of results (scrolling / pagination).

• translate_reviews (string): Example value:

• query (string): Return reviews matching a text query.

• sort_by (string): How to sort the reviews in the results. Default: most_relevant Allowed values: most_relevant, newest, highest_ranking, lowest_ranking

• fields (string): A comma separated list of review fields to include in the response (field projection). By default all fields are returned. Example: review_id,review_text,rating

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

---

business_reviews

Get business reviews by Business Id with pagination support.

端点: GET /business-reviews

参数:

• business_id (string) 必需: Unique Business Id. Accepts google_id / business_id or place_id. Examples: 0x880fd393d427a591:0x8cba02d713a995ed ChIJkaUn1JPTD4gR7ZWpE9cCuow

• limit (number): Maximum number of business reviews to return. Default: 20 Allowed values: 1-1000

• offset (number): Number of business reviews to skip (for pagination/scrolling). Default: 0

• translate_reviews (string): Example value:

• query (string): Return reviews matching a text query.

• sort_by (string): How to sort the reviews in the results. Default: most_relevant Allowed values: most_relevant, newest, highest_ranking, lowest_ranking

• fields (string): A comma separated list of review fields to include in the response (field projection). By default all fields are returned. Example: review_id,review_text,rating

• region (string): Query Google Maps from a particular region or country. For a list of supported region/country codes see https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes (Alpha-2 code). Default: us

• language (string): Set the language of the results. For a list of supported language codes see https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes . Default: en

---

技术栈

• 传输协议: stdio
• HTTP 客户端: httpx

许可证

MIT License - 详见 LICENSE 文件。

开发

此服务器由 API-to-MCP 工具生成。

版本: 1.0.0