Google 搜索控制台 MCP 服务器用于 Claude

此项目提供一个模型上下文协议 (MCP) 服务器，允许 Claude AI（通过 Claude 桌面应用程序）与 Google Search Console API 进行交互。你可以直接从你的 Claude 聊天中查询性能数据、检查 URL、查看索引状态等。

功能

基于此项目中 Google Search Console API 端点允许的功能：

• **站点：**列出你搜索控制台账户可访问的网站/属性。
• **搜索分析：**获取搜索表现数据（点击量、展现量、CTR、排名）以及各种筛选和维度。
• **URL 检查：**检查特定 URL 在 Google 索引中的状态，查看其索引状态并请求索引。
• **Sitemap：**列出网站提交的 Sitemap。
• **(辅助) 获取站点性能摘要（基于搜索分析数据）。

(注意：指数覆盖详细信息和爬取错误通常不在 URL 检查 API 之外通过 Google Search Console API 提供。)

先决条件

• Python： 版本 3.11 或更高。
• pip： Python 包安装程序（通常随 Python 一起提供）。
• 虚拟环境工具： venv（推荐，内置在 Python 3 中）。
• Google 账户： 具有访问你想要查询的 Google Search Console 属性的权限。
• Claude 桌面应用程序： 已安装并运行。

设置说明

1. 克隆或下载： 将项目文件获取到本地机器。如果使用 git：

   git clone <your-repository-url>
   cd search-console-mcp
   

   (将 <your-repository-url> 替换为实际的仓库 URL，否则直接导航到下载目录)

2. 创建并激活虚拟环境： 建议使用虚拟环境来管理依赖项。

   # 创建虚拟环境（使用名称 'fresh_env'）
   python3 -m venv fresh_env
   
   # 激活环境
   # 在 macOS/Linux 上：
   source fresh_env/bin/activate
   # 在 Windows 上：
   # .\fresh_env\Scripts\activate
   

   (你应该会在终端提示符前看到 (fresh_env))

3. 安装依赖项： 安装所需的 Python 包，包括以编辑模式安装的项目。

   pip install -e .
   

4. Google Cloud 设置及凭证：

   • 启用 API： 转到 Google Cloud Console 并创建新项目或选择现有项目。启用“Google Search Console API”。
   • 创建 OAuth 凭证：
     • 转到“API 和服务” -> “凭据”。
     • 点击“+ 创建凭证” -> “OAuth 客户端 ID”。
     • 如果提示，配置“OAuth 同意屏幕”（选择“外部”用户类型，提供应用程序名称如“Claude GSC Tool”，你的电子邮件并保存）。
     • 对于“应用类型”，选择 “桌面应用”。
     • 给它一个名称（例如，“Claude 桌面 GSC 工具”）。
     • 点击“创建”。
   • 下载 credentials.json： 创建后，点击“DOWNLOAD JSON”。将其保存到项目根目录 (search-console-mcp/) 中，并确保不要提交此文件。

5. 运行服务器： 你可以通过以下命令运行服务器：

   python -m search_console_server
   

注意事项

• 确保你安装了正确的 Python 版本和依赖项。
• 在设置 Google API 时，严格按照步骤操作以避免权限问题。
• 不要提交 credentials.json 和生成的 token.json 到版本控制系统中。