内容
# Google Business Profile MCP 服务器
一个 MCP(模型上下文协议)服务器,允许 AI 助手管理您的 Google Business Profile — 创建帖子,回复评论,列出位置等。
为与 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Cursor](https://cursor.com) 和其他 MCP 兼容的 AI 工具一起使用而构建。
## 功能
| 工具 | 描述 |
|---|---|
| `gbp_list_accounts` | 列出所有 GBP 账户 |
| `gbp_list_locations` | 列出某个账户的商业位置 |
| `gbp_create_post` | 创建帖子(标准、事件或优惠)并可选地添加照片/视频和 CTA 按钮 |
| `gbp_list_posts` | 列出某个位置的帖子 |
| `gbp_get_post` | 获取特定帖子的详细信息 |
| `gbp_update_post` | 更新帖子的文本或行动号召 |
| `gbp_delete_post` | 删除帖子 |
| `gbp_list_reviews` | 列出某个位置的评论 |
| `gbp_get_review` | 获取特定评论 |
| `gbp_reply_review` | 代表商家回复评论 |
| `gbp_delete_review_reply` | 删除商家对评论的回复 |
| `gbp_list_media` | 列出某个位置的媒体(照片/视频) |
### 帖子类型
- **标准** — 文本 + 可选图片 + 可选 CTA 按钮(了解更多、预订、购物等)
- **事件** — 包含标题、开始/结束日期和时间
- **优惠** — 包含优惠码、条款和兑换网址
## 先决条件
1. 一个 [Google Cloud 项目](https://console.cloud.google.com/),且已启用 **我的商家商业信息 API** 和 **我的商家账户管理 API**
2. 一个 **OAuth 2.0 客户端 ID**(桌面或网页类型),且 `http://localhost:3456/callback` 作为授权重定向 URI
3. 您的 Google 账户必须能够访问 [Google Business Profile](https://business.google.com/)
## 设置
### 1. 克隆和安装
```bash
git clone https://github.com/narkov/gbp-mcp.git
cd gbp-mcp
npm install
npm run build
```
### 2. 配置凭证
复制示例 env 文件并填写您的 OAuth 凭证:
```bash
cp .env.example .env
```
编辑 `.env`:
```
GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-your-secret
```
### 3. 与 Google 授权(一次性)
```bash
npm run auth
```
这会打开一个 Google OAuth 同意浏览器。批准后,令牌将保存到 `credentials/gbp-tokens.json` 并在后续使用时自动刷新。
### 4. 添加到您的 MCP 客户端
#### Claude Code(`.mcp.json`)
```json
{
"mcpServers": {
"gbp": {
"command": "node",
"args": ["dist/index.js"],
"cwd": "/path/to/gbp-mcp",
"env": {
"GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "GOCSPX-your-secret"
}
}
}
}
```
#### Cursor(`~/.cursor/mcp.json`)
格式与上述相同。
## 使用示例
连接后,您的 AI 助手可以:
```
"列出我的所有 GBP 位置"
"在 Kyiv 位置创建一个关于春季促销的帖子,并附上 Shop Now 按钮"
"显示最近的评论并为负面评论草拟回复"
"删除上周过期的优惠帖子"
```
## API 参考
此服务器使用以下 Google API:
- [我的商家账户管理 API](https://developers.google.com/my-business/reference/accountmanagement/rest) — 账户
- [我的商家商业信息 API](https://developers.google.com/my-business/reference/businessinformation/rest) — 位置
- [Google 我的商家 API v4](https://developers.google.com/my-business/reference/rest) — 帖子、评论、媒体
## 许可证
MIT