Google Business Profile MCP

本地服务

github.com商业与营销44 周前更新

关于 Google Business Profile MCP

Google Business Profile MCP 让 AI 应用通过自然语言查看和管理商家资料，涵盖位置、评价、帖子及表现数据。写入操作需由客户端确认，并且使用相关 API 前必须获得 Google 的 Basic API Access 批准。

主要功能

01查看位置、类别和资料属性
02查询表现指标与评价
03起草并发布评价回复
04创建、更新或删除本地帖子
05确认后修改公开资料

适用场景

01汇总多个门店的最新未回复评价
02起草并经确认发布评价回复
03按时段查看来电和搜索表现
04更新门店资料或本地帖子

MCP 相关

MCP 服务向客户端提供 20 个工具，用于访问账户、商家信息、表现、评价、帖子、类别和属性。客户端确认后才能执行公开内容或资料的写入操作；API 调用还需 Google 批准 Basic API Access。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "a1-x-tech-mcp-google-business": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-business"
      ],
      "env": {
        "GOOGLE_BUSINESS_CLIENT_ID": "<GOOGLE_BUSINESS_CLIENT_ID>",
        "GOOGLE_BUSINESS_CLIENT_SECRET": "<GOOGLE_BUSINESS_CLIENT_SECRET>",
        "GOOGLE_BUSINESS_REFRESH_TOKEN": "<GOOGLE_BUSINESS_REFRESH_TOKEN>",
        "GOOGLE_BUSINESS_ACCESS_TOKEN": "<GOOGLE_BUSINESS_ACCESS_TOKEN>",
        "GOOGLE_BUSINESS_TIMEOUT_MS": "<GOOGLE_BUSINESS_TIMEOUT_MS>",
        "GOOGLE_BUSINESS_MAX_RETRIES": "<GOOGLE_BUSINESS_MAX_RETRIES>",
        "GOOGLE_BUSINESS_OAUTH_PORT": "<GOOGLE_BUSINESS_OAUTH_PORT>",
        "GOOGLE_BUSINESS_ACCOUNTS_API_BASE": "<GOOGLE_BUSINESS_ACCOUNTS_API_BASE>",
        "GOOGLE_BUSINESS_INFO_API_BASE": "<GOOGLE_BUSINESS_INFO_API_BASE>",
        "GOOGLE_BUSINESS_PERFORMANCE_API_BASE": "<GOOGLE_BUSINESS_PERFORMANCE_API_BASE>",
        "GOOGLE_BUSINESS_V4_API_BASE": "<GOOGLE_BUSINESS_V4_API_BASE>"
      }
    }
  }
}

启动命令npx -y mcp-google-business

需要配置的环境变量

GOOGLE_BUSINESS_CLIENT_IDOAuth2 client id from Google Cloud Console (refresh flow).

GOOGLE_BUSINESS_CLIENT_SECRET密钥OAuth2 client secret. Treat it as a secret.

GOOGLE_BUSINESS_REFRESH_TOKEN密钥OAuth2 refresh token with the business.manage scope. Treat it as a secret.

GOOGLE_BUSINESS_ACCESS_TOKEN密钥Ready-made access token (~1 h) as an alternative to the refresh-flow trio above.

GOOGLE_BUSINESS_TIMEOUT_MSPer-request timeout in milliseconds.

GOOGLE_BUSINESS_MAX_RETRIESRetries on transient errors (429 always; 5xx/network on idempotent calls).

GOOGLE_BUSINESS_OAUTH_PORT密钥Fixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.

GOOGLE_BUSINESS_ACCOUNTS_API_BASEAccount Management API base override.

GOOGLE_BUSINESS_INFO_API_BASEBusiness Information API base override.

GOOGLE_BUSINESS_PERFORMANCE_API_BASEBusiness Profile Performance API base override.

GOOGLE_BUSINESS_V4_API_BASELegacy v4 My Business API base override (reviews, local posts).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-google-business1.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Google Business Profile MCP

English | Русский

A1 Google Business Profile MCP 可让 AI 应用通过自然语言处理您的 Google Business Profile 地点。查看地点和业绩、回复评价、准备本地帖子，并按需更新个人资料信息。

它连接到 Google 当前的 Business Profile API，以及仍用于评价和帖子的旧版 API。仅有 Google 账号和 OAuth 凭据还不够：Google 必须批准 Cloud 项目的 Basic API Access。

20 个工具。 地点和账号数据、业绩、评价、本地帖子、类别和属性。
实际审批门槛。 项目起始 QPM 为 0；在 Google 批准 Basic API Access 申请之前，每次 API 调用都会失败。
独立的发布边界。 准备好的回复、帖子或地点更新，只有在客户端确认写入操作后才会更改公开的商家信息。
四种 API。 Account Management、Business Information、Performance 和旧版 v4 通过一个 business.manage OAuth 作用域运行。

先从只读问题开始：

列出我的地点，并显示最新的未回复评价。

连接服务 · 探索使用场景 · 查看技术文档

一分钟了解它的工作方式

您：列出我的地点，并显示最新的未回复评价。

助手： 显示地点和近期评价。不会进行任何更改。

您：为市中心地点最新的三星评价拟一条回复。表示歉意并提出愿意提供帮助。

助手： 显示地点、评价和拟好的回复，然后在发布前请求确认。

您：确认。

助手： 发布回复。不会修改评价、其他地点或帖子。

快速开始

你需要 Node.js 20+、已验证的 Google Business Profile、Google Cloud OAuth 客户端，以及获批的 Basic API Access 应用。

获取已批准的访问权限。
将服务添加到你的 AI 应用。
从上面的只读问题开始。

Codex

在 Settings → MCP servers 中，选择 Add server，选择 STDIO，输入命令 npx -y mcp-google-business@latest 和环境变量 GOOGLE_BUSINESS_CLIENT_ID、GOOGLE_BUSINESS_CLIENT_SECRET、GOOGLE_BUSINESS_REFRESH_TOKEN，然后选择 Save 和 Restart。

codex mcp add google-business \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-business@latest
codex mcp list

Codex MCP 文档

Claude Code

claude mcp add \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-business \
  -- npx -y mcp-google-business@latest
claude mcp list

Claude Code MCP 文档

Claude Desktop

当前的官方路径是 Settings → Extensions。要安装自定义桌面扩展，请打开 Advanced settings → Extension Developer → Install Extension…，选择 .mcpb 文件并按提示操作。

此代码库目前发布的是 npm stdio 包，不包含 .mcpb 包。对于仍支持本地配置的 Claude Desktop 版本，可将以下 JSON stdio 配置用作备用方案：

{"mcpServers":{"google-business":{"command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}}

在这些版本中，macOS 上将其保存到 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上则保存到 %APPDATA%\Claude\claude_desktop_config.json。

Claude Desktop MCP 文档

Cursor

在 macOS/Linux 上，将 {"mcpServers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}} 添加到 ~/.cursor/mcp.json；在 Windows 上则添加到 %USERPROFILE%\.cursor\mcp.json。Cursor MCP 文档

VS Code

运行 MCP: Open User Configuration 并添加：

{"servers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"${input:gbp_client_id}","GOOGLE_BUSINESS_CLIENT_SECRET":"${input:gbp_client_secret}","GOOGLE_BUSINESS_REFRESH_TOKEN":"${input:gbp_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gbp_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gbp_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gbp_refresh_token","description":"Google OAuth refresh token","password":true}]}

使用 MCP: List Servers 检查配置。VS Code MCP 文档

可以让它做什么

列出营业地点、类别、属性和当前商家资料信息。
显示所选时间段内的来电、路线请求和搜索关键词展示次数。
查找最新评价、起草回复，并在确认后发布。
创建、更新或删除本地帖子。
显示具体变更内容后，更新所选营业地点字段或属性。

可以进行哪些变更

操作	执行内容	确认边界
账号、营业地点、类别、属性、绩效、评价和帖子	读取现有商家资料数据	不会产生变更
更新营业地点或其属性	更改公开的商家资料数据	更改营业地点
回复评价	发布公开的商家回复	更改公开内容
创建或更新本地帖子	发布或更改公开的本地内容	更改公开内容
删除评价回复或本地帖子	移除公开内容	具有破坏性
原始 API 请求	可能调用任何写入或删除端点	可能具有破坏性

AI 客户端负责控制确认流程；服务会为工具添加标记，以便客户端区分检查操作和实际变更。

获取访问权限

Google 要求同时获得 OAuth 和 Basic API Access 的批准。

使用已验证且处于活跃状态、已存在至少 60 天的商家资料；从所有者或经理账号提交申请，并确保商家网站与申请内容一致。
创建 Google Cloud 项目，启用 My Business Account Management API、Business Information API、Business Profile Performance API 和 Google My Business API（旧版 v4）。
以 Application for Basic API Access 的名义提交 GBP API 联系表单。获批前，配额为 0 QPM；获批项目的每个 API 配额为 300 QPM。
创建 OAuth 客户端，为 https://www.googleapis.com/auth/business.manage 获取刷新令牌，并设置三个 GOOGLE_BUSINESS_* 变量。

请将客户端密钥和刷新令牌视为密码。访问令牌是用于一次性操作的短期替代方案。

配置

变量	必填	说明
`GOOGLE_BUSINESS_CLIENT_ID`	是*	OAuth 客户端 ID。
`GOOGLE_BUSINESS_CLIENT_SECRET`	是*	OAuth 客户端密钥。
`GOOGLE_BUSINESS_REFRESH_TOKEN`	是*	具有 `business.manage` 权限的 OAuth 刷新令牌。
`GOOGLE_BUSINESS_ACCESS_TOKEN`	是*	OAuth 三项配置的短期替代方案。
`GOOGLE_BUSINESS_TIMEOUT_MS`	否	单次请求超时时间；默认值为 `60000` 毫秒。
`GOOGLE_BUSINESS_MAX_RETRIES`	否	临时错误重试次数；默认值为 `3`。

* 提供 OAuth 三项配置或访问令牌之一即可。API 主机覆盖配置见工具参考。

数据、限制和后台工作

Google 会收到资料请求。 匿名遥测包含安装和版本数据以及工具名称，不包含 OAuth 密钥、资料数据、参数或提示词。设置 ASKADS_TELEMETRY=0 即可选择退出。
实际编辑上限。 获批项目的每个 API 配额为 300 QPM；Google 还将每个商家资料的编辑限制为每分钟 10 次。效果指标可能延迟几天，回复评价需要已验证的地点。
不进行后台监控。 服务仅在被调用时运行。如果你的 AI 应用支持计划任务，可以定期查看新反馈或指标。