Google Business Profile Review MCP Server

谷歌商业概况审查MCP服务器

模型上下文协议（MCP）服务器，使AI助手能够通过智能自动化管理Google Business Profile审核。

特性

• 评论管理：获取并分析Google Business Profile评论
• AI驱动的响应：使用LLM采样生成符合上下文的回复
• 自动发布：将回复发布回Google Business Profile
• OAuth集成：使用Google API进行安全身份验证
• 速率限制：尊重API使用，内置速率限制
• 结构化日志记录：用于调试和监控的全面日志记录

先决条件

• Node.js 18.0.0或更高版本
• 启用了My Business API的Google云平台帐户
• 谷歌OAuth 2.0证书
• Google业务简介API访问 （见以下要求）

Google Business Profile API访问要求

在您可以使用此MCP服务器之前，您必须请求并批准Google Business Profile API访问。谷歌要求所有申请人：

1. 管理经过验证的谷歌商业档案 已激活60多天

- 这可以是您自己的业务，也可以是您管理的客户业务

1. 拥有一个网站 代表谷歌商业简介中列出的企业
2. 完整的谷歌商业简介 有最新的信息

请求API访问：

1. 转到 谷歌云控制台 并从项目信息卡中记下您的项目编号
2. 使用以下方式提交您的请求 英镑API联系表

- 从下拉列表中选择“基本API访问的应用程序” - 提供您的项目编号和所有要求的信息 - 使用企业英镑上列出的所有者/经理电子邮件地址

1. 等待审核-您将收到一封包含决定的后续电子邮件

检查审批状态 通过在Google Cloud Console中查看配额：

• 0 QPM（每分钟查询数） =尚未批准
• 300 QPM =已批准✓

有关完整的先决条件，请参阅 API英镑官方文件.

设置

1.谷歌云配置

1. 转到 谷歌云控制台
2. 创建新项目或选择现有项目
3. 请求GBP API访问 （见上述要求-此步骤至关重要，可能需要时间批准）
4. 启用以下API （在您的项目获得批准后）：

- 转到“API和服务”>“库” - 搜索并启用 “Google My Business API” - 搜索并启用 “我的企业帐户管理API”

1. 创建OAuth 2.0凭据：

- 转到API和服务部分中的“凭据” - 点击“创建凭据”>“OAuth 2.0客户端ID” - 将应用程序类型设置为“Web应用程序” - 添加授权重定向URI： http://localhost:3000/auth/callback - 记下客户端ID和客户端密码

1. 配置OAuth同意屏幕:

- 转到“API和服务”>“OAuth同意屏幕” - 添加测试用户（可以访问业务配置文件的Google帐户电子邮件） - 添加所需范围： business.manage, userinfo.email, userinfo.profile

2.安装

# Clone the repository
git clone 
cd review-mcp

# Install dependencies
npm install

# Build the project
npm run build

3.配置

# Copy the environment template
cp .env.example .env

# Edit .env with your credentials
# Add your Google OAuth credentials and other settings

所需的环境变量：

• GOOGLE_CLIENT_ID：您的Google OAuth 2.0客户端ID
• GOOGLE_CLIENT_SECRET：您的Google OAuth 2.0客户端密码
• GOOGLE_REDIRECT_URI：OAuth重定向URI（默认值：http://localhost:3000/auth/callback)

4.身份验证

在运行服务器之前，您需要向Google进行身份验证：

# Run the authentication helper
npm run auth

这将：

1. 打开浏览器，进入谷歌的身份验证页面
2. 要求您授予访问您的Google Business Profile的权限
3. 在本地保存身份验证令牌
4. 这些令牌将由MCP服务器自动使用

5.运行服务器

# Start the server with your authenticated credentials
npm start

# Or in development/mock mode for testing
npm run start:mock

服务器将从用于MCP通信的STDIO传输开始。

用法

连接到MCP客户端

您可以使用任何兼容MCP的客户端连接到此服务器：

VS代码（GitHub副本）

添加到您的VS Code MCP设置文件(mcp.json):

窗户： %APPDATA%\Code\User\profiles\ \mcp.json\ macOS/Linux： ~/.config/Code/User/profiles/ /mcp.json

{
  "servers": {
    "google-business-reviews": {
      "type": "stdio",
      "command": "node",
      "args": [
        "C:\\path\\to\\review-mcp\\build\\index.js"
      ],
      "cwd": "C:\\path\\to\\review-mcp",
      "env": {
        "NODE_ENV": "production",
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/auth/callback",
        "LOG_LEVEL": "info"
      },
      "description": "Google Business Profile Review MCP Server - Manage reviews with AI-powered responses"
    }
  }
}

重要提示：

• 替换 C:\\path\\to\\review-mcp 与项目的实际路径
• 使用双反睫毛(\\)在Windows路径中
• 替换 your-client-id 和 your-client-secret 使用您的实际OAuth凭据
• 一定要跑 npm run auth 在VS Code中使用前先进行身份验证
• 添加配置后重新启动VS Code

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "google-business-reviews": {
      "command": "node",
      "args": ["/path/to/review-mcp/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/auth/callback"
      }
    }
  }
}

HTTP客户端

连接到： http://localhost:3000/mcp

可用工具

1. list_locations：获取与您的帐户关联的所有业务地点
2. get_reviews：获取特定位置的评论
3. generate_reply：生成人工智能对评论的回应
4. post_reply：对Google Business Profile上的评论发表回复

可用资源

1. business_profile：业务简介信息和设置
2. review_templates：预定义的响应模板

可用提示

1. review_response：生成专业评审回复
2. sentiment_analysis：分析评论情绪

发展

项目结构

src/
├── index.ts              # Main server entry point
├── server/               # MCP server implementation
│   ├── mcpServer.ts     # Core MCP server setup
│   ├── tools/           # Tool implementations
│   ├── resources/       # Resource implementations
│   └── prompts/         # Prompt implementations
├── services/            # Business logic services
│   ├── googleAuth.ts    # Google OAuth handling
│   ├── reviewService.ts # Review management
│   └── llmService.ts    # LLM interaction
├── types/               # TypeScript type definitions
└── utils/               # Utility functions

脚本

• npm run dev：使用热重载启动开发服务器
• npm run build：构建TypeScript项目
• npm run lint：运行ESLint
• npm run test：运行测试
• npm run clean：清理生成目录

API文档

身份验证流程

1. 用户通过MCP客户端启动OAuth流
2. 服务器重定向到Google OAuth同意屏幕
3. 用户授予Google My Business访问权限
4. 服务器接收授权码并交换访问令牌
5. 令牌被安全地存储以供后续API调用使用

速率限制

服务器执行速率限制以遵守Google API配额：

• 每位用户每分钟60个请求（可配置）
• 失败请求的指数回退
• 对超出配额的错误处理得当

安全注意事项

• 所有Google API调用都使用OAuth 2.0身份验证
• 访问令牌被安全地存储并自动刷新
• 对所有用户输入进行输入验证和净化
• 限制利率以防止滥用
• 用于安全监控的全面日志记录

故障排除

常见问题

1. OAuth错误：确保重定向URI与Google Cloud Console中配置的完全匹配
2. 超过API配额：检查您的Google云控制台以了解API的使用情况和限制
3. 权限不足：验证Google帐户是否可以访问企业简介

日志记录

通过设置启用调试日志记录 LOG_LEVEL=debug 在你的 .env 文件。

贡献

1. 复刻仓库
2. 创建要素分支
3. 进行更改
4. 添加新功能的测试
5. 运行测试套件
6. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

支持

对于问题和疑问：

1. 检查故障排除部分
2. 在启用调试级别的情况下查看日志
3. 在GitHub上打开一个问题，提供有关该问题的详细信息