麦克佩斯-游戏服务器控制

Name: 麦克佩斯-游戏服务器控制
Author: AminForou

作者：AminForou147 星标更新：2025-04-09

安装使用来源：spider==github.com

项目介绍

Google Search Console MCP服务器用于SEO

这是一个连接Google Search Console（GSC）与Claude AI的工具，允许您通过自然语言对话分析您的SEO数据。此集成让您可以通过与Claude的简单聊天访问网站信息、搜索分析、URL检查和站点地图管理等功能。

此工具对SEO专业人士有何帮助？

网站管理
- 在一个地方查看所有GSC网站
- 获取验证详情和基本网站信息
- 向账户添加新网站
- 从账户中移除网站
搜索分析与报告
- 发现哪些搜索查询将访客带到您的网站
- 跟踪展示次数、点击次数和点击率
- 分析随时间变化的表现趋势
- 比较不同时间段以发现变化
- 使用Claude生成的图表和图形可视化您的数据
URL检查与索引
- 检查特定页面是否有索引问题
- 查看Google上次爬取您的页面的时间
- 一次性检查多个URL以识别模式
- 获取如何改进索引的具体建议
站点地图管理
- 查看所有站点地图及其状态
- 直接通过Claude提交新的站点地图
- 检查站点地图中的错误或警告
- 监控站点地图处理状态

可用工具

一旦设置好此集成，您可以要求Claude执行以下操作：

您可以请求的内容	它会做什么	您需要提供什么
`list_properties`	显示所有GSC网站	无需提供任何内容 - 直接询问即可！
`get_site_details`	显示特定网站的详细信息	您的网站URL
`add_site`	向GSC网站属性添加新网站	您的网站URL
`delete_site`	从GSC网站属性中删除网站	您的网站URL
`get_search_analytics`	显示顶级查询和页面的指标	您的网站URL和时间段
`get_performance_overview`	提供网站表现概览	您的网站URL和时间段
`check_indexing_issues`	检查页面是否有索引问题	您的网站URL和要检查的页面列表
`inspect_url_enhanced`	对特定URL进行详细检查	您的网站URL和要检查的页面
`get_sitemaps`	列出所有站点地图	您的网站URL
`submit_sitemap`	向Google提交新的站点地图	您的网站URL和站点地图URL

如需了解所有19个可用工具及其详细描述，请在设置后要求Claude“列出工具”。

开始使用（无需编程经验）

1. 设置Google Search Console API访问权限

在使用此工具之前，您需要创建API凭据，以便Claude可以访问您的GSC数据：

认证选项

该工具支持两种认证方法：

1. OAuth认证（推荐）

此方法允许您用自己的Google帐户进行认证，通常比使用服务帐户更方便。它将具有与您通常相同的资源访问权限。

将GSC_SKIP_OAUTH设置为“true”、“1”或“yes”，以跳过OAuth认证并仅使用服务帐户认证

设置说明：

如果没有，请前往Google Cloud Console创建一个Google Cloud帐户
创建一个新的项目或选择现有的项目
为您的项目启用Search Console API
为您的项目添加范围 https://www.googleapis.com/auth/webmasters
前往"凭证"页面
点击"创建凭证"并选择"OAuth客户端ID"
配置OAuth同意屏幕
对于应用类型，选择"桌面应用"
给您的OAuth客户端命名并点击"创建"
下载客户端密钥JSON文件（命名为类似client_secrets.json）
将此文件放置在脚本所在的同一目录中，或设置GSC_OAUTH_CLIENT_SECRETS_FILE环境变量指向其位置

首次运行带有OAuth认证的工具时，它将打开浏览器窗口，要求您登录到Google帐户并授权应用程序。授权后，工具将保存令牌以备将来使用。

2. 服务帐户认证

此方法使用服务帐户，适用于自动化脚本或不想使用个人Google帐户的情况。这需要将服务帐户添加为Google Search Console中的用户。

设置说明：

如果没有，请前往Google Cloud Console创建一个Google Cloud帐户
创建一个新的项目或选择现有的项目
为您的项目启用Search Console API
前往"凭证"页面
点击"创建凭证"并选择"服务帐户"
填写服务帐户详细信息并点击"创建"
点击新创建的服务帐户
转到"密钥"标签并点击"添加密钥">"创建新密钥"
选择JSON格式并点击"创建"
下载密钥文件，并将其保存为service_account_credentials.json在脚本所在的同一目录中，或设置GSC_CREDENTIALS_PATH环境变量指向其位置
将您的服务帐户电子邮件地址添加到适当的Search Console属性中

🎬 观看这个适合初学者的YouTube教程：

点击上方图片观看分步视频教程

2. 安装所需软件

您需要在计算机上安装这些工具：

Python（版本3.11或更新） - 这运行了GSC和Claude之间的连接
Node.js - 执行MCP检查器和某些MCP组件所需的
Claude Desktop - 您将与其聊天的AI助手

确保Python和Node.js已正确安装并在系统路径中可用后再继续。

3. 下载Google Search Console MCP

您需要将此工具下载到您的计算机上。最简单的方法是：

点击此页面顶部的绿色"代码"按钮
选择"下载ZIP"
将下载的文件解压到一个容易找到的位置（例如文档文件夹）

如果您熟悉Git：

git clone https://github.com/AminForou/mcp-gsc.git

4. 安装所需组件

打开您的计算机终端（Mac）或命令提示符（Windows）：

导航到您解压文件的文件夹：

# 示例（替换为您实际路径）：
cd ~/Documents/mcp-gsc-main

创建虚拟环境（这使项目依赖项隔离）：

# 使用uv（推荐）：
uv venv .venv

# 如果未安装uv，请先安装：
pip install uv
# 然后创建虚拟环境：
uv venv .venv

# 或者使用标准Python：
python -m venv .venv

注意： 如果尝试安装uv时遇到“pip未找到”的错误，请参阅下面的“如果遇到‘pip未找到’错误”部分。

激活虚拟环境：

# 在Mac/Linux上：
source .venv/bin/activate

# 在Windows上：
.venv\Scripts\activate

安装所需依赖项：

# 使用uv：
uv pip install -r requirements.txt

# 或者使用标准pip：
pip install -r requirements.txt

如果遇到“pip未找到”错误：

# 首先确保pip已安装并更新：
python3 -m ensurepip --upgrade
python3 -m pip install --upgrade pip

# 然后再次尝试安装需求：
python3 -m pip install -r requirements.txt

# 或者安装uv：
python3 -m pip install uv

当您看到命令提示符开头有(.venv)时，表示虚拟环境已激活，依赖项将安装在那里而不会影响您的系统Python安装。

5. 连接Claude到Google Search Console

如果尚未安装，请下载并安装Claude Desktop
确保您已在计算机上保存了Google服务帐户凭据文件
打开您的计算机终端（Mac）或命令提示符（Windows），然后键入：

   # 对于Mac用户：
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # 对于Windows用户：
   notepad %APPDATA%\Claude\claude_desktop_config.json

添加以下配置文本（这告诉Claude如何连接到GSC）：

OAuth认证（使用您自己的帐户）

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-gsc-main/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/FULL/PATH/TO/client_secrets.json"
      }
    }
  }
}

服务帐户认证

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-gsc-main/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/FULL/PATH/TO/service_account_credentials.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

重要： 替换所有路径为您计算机上的实际位置：

第一个路径应指向虚拟环境内的Python可执行文件
第二个路径应指向您解压的文件夹内的gsc_server.py文件
第三个路径应指向您的Google服务帐户凭据JSON文件

示例：

Mac：
- Python路径：/Users/yourname/Documents/mcp-gsc/.venv/bin/python
- 脚本路径：/Users/yourname/Documents/mcp-gsc/gsc_server.py
Windows：
- Python路径：C:\\Users\\yourname\\Documents\\mcp-gsc\\.venv\\Scripts\\python.exe
- 脚本路径：C:\\Users\\yourname\\Documents\\mcp-gsc\\gsc_server.py

保存文件：
- Mac：按Ctrl+O，然后按Enter，再按Ctrl+X退出
- Windows：点击文件>保存，然后关闭记事本
重新启动Claude Desktop
当Claude打开时，您现在应该能在工具部分看到GSC工具

6. 开始分析您的SEO数据！

现在您可以向Claude询问关于您的GSC数据的问题！Claude不仅可以检索数据，还可以分析数据，解释趋势，并创建可视化以帮助您更好地理解您的SEO表现。

这里有一些强大的提示，您可以与每个工具一起使用：

工具名称	示例提示
`list_properties`	"列出我所有的GSC网站，并告诉我哪些网站索引的页面最多。"
`get_site_details`	"分析mywebsite.com的验证状态，并解释所有权详情意味着什么。"
`add_site`	"将我的新网站https://mywebsite.com添加到Search Console并验证其状态。"
`delete_site`	"从Search Console中移除旧测试站点https://test.mywebsite.com。"
`get_search_analytics`	"显示过去30天内mywebsite.com的前20个搜索查询，突出显示CTR低于2%的任何查询，并建议标题改进。"
`get_performance_overview`	"创建过去28天内mywebsite.com的视觉表现概述，识别任何异常下降或上升，并解释可能的原因。"
`check_indexing_issues`	"检查这些重要页面的索引问题，并优先考虑哪些页面需要立即关注：mywebsite.com/product, mywebsite.com/services, mywebsite.com/about"
`inspect_url_enhanced`	"对我website.com/landing-page进行全面检查，并给我提高其索引状态的操作建议。"
`batch_url_inspection`	"检查我的前5个产品页面，识别常见的爬行或索引模式，并建议技术SEO改进。"
`get_sitemaps`	"列出mywebsite.com的所有站点地图，识别任何有错误的站点地图，并推荐下一步行动。"
`list_sitemaps_enhanced`	"分析mywebsite.com的所有站点地图，重点关注错误模式，并创建优先行动计划。"
`submit_sitemap`	"提交我在https://mywebsite.com/product-sitemap.xml的新产品站点地图，并解释Google通常需要多长时间来处理它。"
`get_sitemap_details`	"检查我在mywebsite.com/sitemap.xml的主要站点地图的状态，并解释警告对我的SEO意味着什么。"
`get_search_by_page_query`	"哪些搜索词驱动流量到我的博客文章mywebsite.com/blog/post-title？识别优化相关关键词的机会。"
`compare_search_periods`	"比较我的网站在一月和二月的表现。哪些查询改善最多，哪些下降，以及可能解释这些变化的原因是什么？"
`get_advanced_search_analytics`	"分析我的移动搜索性能，针对高展示次数但排名低于第10位的查询，并建议内容改进以帮助它们获得更好的排名。"

您也可以要求Claude结合多个工具并分析结果。例如：

"找出我流量最高的20个落地页，检查它们的索引状态，并创建一份报告，突出显示那些既有高流量又有索引问题的页面。"
"分析我网站在过去90天的表现趋势，识别增长最快的查询，并检查相应的落地页是否有任何技术问题。"
"比较我的桌面与移动搜索性能，用图表可视化差异，并根据性能差距推荐需要移动优化的具体页面。"
"识别我在第2页（位置11-20）排名且有高展示次数但低CTR的查询，然后检查相应的URL并建议标题和元描述改进。"

Claude将使用GSC工具获取数据，在易于理解的格式下呈现数据，创建有助于理解信息的可视化，并基于结果提供操作建议。

数据可视化能力

Claude可以帮助您以多种方式可视化您的GSC数据：

趋势图：查看指标如何随时间变化
比较图：比较不同的时间段或维度
性能分布：了解您的内容在各个位置的表现
相关性分析：识别不同指标之间的关系
热力图：用颜色编码的表示形式可视化复杂的数据集

只需在分析数据时要求Claude“可视化”或“创建图表”，它将生成适当的可视化以帮助您更好地理解信息。

故障排除

Python命令未找到

在macOS上，默认的Python命令通常是python3而不是python，这可能会导致一些应用程序（包括Node.js集成）出现问题。

如果您遇到与Python未找到相关的错误，可以创建别名：

创建Python别名（一次设置）：

# 对于macOS用户：
sudo ln -s $(which python3) /usr/local/bin/python

# 如果不起作用，尝试查找您的Python安装：
sudo ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /usr/local/bin/python

验证别名是否有效：
```
python --version
```

这创建了一个符号链接，因此当应用程序调用python时，实际上会使用您的python3安装。

Claude配置问题

如果您遇到连接问题：

确保配置中的所有文件路径都是正确的，并使用完整路径
检查您的服务帐户是否有访问您的GSC属性的权限
在进行任何更改后重新启动Claude Desktop
尝试使用工具时，查看Claude响应中的错误消息
确保在手动运行服务器时激活了虚拟环境

其他意外问题

如果您在安装或使用过程中遇到其他意外问题：

复制您收到的确切错误消息
使用ChatGPT或Claude详细解释您的问题，包括：
- 您正在尝试做什么
- 确切的错误消息
- 您的操作系统
- 您已经尝试过的任何步骤
AI助手通常可以通过建议具体的解决方案来诊断和解决技术问题

请记住，大多数问题以前都曾被其他人遇到过，通常有一个简单的解决方案可用。

贡献

发现了一个bug或有改进建议？我们欢迎您提出意见！在GitHub上打开一个问题或提交一个拉取请求。

许可

本项目根据MIT许可发布。详情见LICENSE文件。