Google Search Console MCP 服务器

本项目提供了一个模型上下文协议 (MCP) 服务器，允许 Claude AI（通过 Claude Desktop 应用程序）或其他程序与 Google Search Console API 交互。您可以使用它直接从 Claude 聊天（或其他程序）查询效果数据、检查 URL、检查索引状态等。

您可以在 X 上关注我 @metehan777，并访问我的博客 https://metehan.ai

功能

基于本项目中允许使用的 Google Search Console API 端点：

• 网站: 列出您 Search Console 帐户中可访问的网站/资源。
• 搜索分析: 获取搜索效果数据（点击次数、展示次数、点击率、排名），并具有各种过滤器和维度。
• 网址检查: 检查特定网址在 Google 索引中的状态，检查其索引状态，并请求索引。
• 站点地图: 列出网站已提交的站点地图。
• (助手) 获取网站整体效果摘要（从搜索分析数据中得出）。

(注意：超出网址检查 API 中可用范围的索引覆盖率详细信息和抓取错误通常不会通过 Google Search Console API 公开。)

请在此处查看 Search Console API 的功能和公告：https://developers.google.com/webmaster-tools/v1/api_reference_index?hl=tr

前提条件

• Python: 3.11 或更高版本。
• pip: Python 包安装程序（通常随 Python 一起提供）。
• 虚拟环境工具: venv（推荐，内置于 Python 3）。
• Google 帐户: 具有访问您要查询的 Google Search Console 资源的权限。
• Claude Desktop 应用程序: 已安装并正在运行。

设置说明

1. 克隆或下载: 将项目文件获取到您的本地计算机上。如果使用 git：

   git clone https://github.com/metehan777/google-search-console-mcp.git
   cd search-console-mcp
   

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 Desktop GSC Tool”）。
     • 单击“创建”。
   • 下载 credentials.json: 创建后，单击“下载 JSON”。将此文件直接保存到您的项目目录的根目录 (search-console-mcp/) 中，并确保将其命名为 credentials.json。
   • 重要提示: 确保 credentials.json 列在您的 .gitignore 文件中，以避免意外提交它。

5. 初始身份验证:

   • 首次运行需要身份验证的工具（无论是手动还是通过 Claude）时，它将触发 Google OAuth 流程。
   • 您的 Web 浏览器应该会打开，要求您登录到有权访问您的 Search Console 资源的 Google 帐户。
   • 授予您配置的应用程序（“Claude GSC Tool”）请求的权限。
   • 成功授权后，将在您的项目目录中创建一个 token.json 文件。 这存储您的访问令牌。如果您要 fork 此 repo 并再次推送/拉取它，请不要提交 token.json。

运行服务器（开发/测试）

虽然主要用途是通过 Claude Desktop 集成，但您可以使用 stdio 传输直接测试服务器： 服务器将启动并等待标准输入/输出上的 JSON-RPC 消息。您可以按 Ctrl+C 停止它。日志将打印到标准错误。

Claude Desktop 集成

要使这些工具在 Claude Desktop 应用程序中可用：

1. 找到配置文件: 找到 Claude Desktop 配置文件。在 macOS 上，它通常位于： ~/Library/Application Support/Claude/claude_desktop_config.json

2. 编辑配置: 在文本编辑器中打开该文件。添加或修改 mcpServers 部分，以包含此工具的条目。使用虚拟环境中 python3 可执行文件的绝对路径。

   {
     "mcpServers": {
       "filesystem": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-filesystem",
           "/Users/username/Desktop",
           "/Users/username/Downloads"
         ]
       },
       "google-search-console": {
         "command": "/Users/username/Documents/search-console-mcp/fresh_env/bin/python3",
         "args": [
           "-m",
           "main"
         ],
         "cwd": "/Users/username/Cursor/search-console-mcp"
       }
     }
   }
   

   • 重要提示: 将 /Users/username/Documents/search-console-mcp 替换为您系统上项目目录的实际绝对路径，包括 command 和 cwd 字段。
   • 如果您的 mcpServers 中已经有其他服务器，只需将 "google-search-console": { ... } 块添加到它们旁边即可。

3. 重启 Claude Desktop: 关闭并重新打开 Claude Desktop 应用程序，以使更改生效。

在 Claude 中使用

设置并集成后，您可以要求 Claude 使用这些工具。例子：

• “列出我在 Google Search Console 中的网站。”
• “获取 example.com 过去 7 天的搜索效果，按查询细分。”
• “检查网站 example.com 上的 URL https://example.com/my-page。”
• “example.com 是否存在任何移动设备可用性问题？”
• “提交 https://example.com/new-article 以在网站 example.com 上进行索引。”

Claude 应该识别合适的工具并通过 MCP 服务器执行它。如果出现提示，请记住在初始身份验证流程中授予权限。

您可以随时贡献或提出改进建议！