MCP服务器管理控制台

Name: MCP服务器管理控制台
Author: seotesting-com

作者：seotesting-com9 星标更新：2025-03-18

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

项目介绍

Google 搜索控制台 MCP 服务器

🚀 简介：设置 MCP 服务器

在本教程中，我们将引导您完成设置自己的 MCP 模型上下文协议服务器的过程，并将其添加到 Claude Desktop 中，同时与 Google 搜索控制台（GSC）数据进行集成。这将允许您比较时间周期以识别搜索引擎优化改进，生成诸如条形图和折线图之类的可视化报告，并通过分析点击率、展示次数和排名变化来发现优化机会。

让我们开始吧！🚀

🔹 我们将涵盖的内容：

生成 Google Cloud 凭证 – 创建并下载服务账户 JSON 密钥以验证 API 访问。
安装所需工具 – 确保您的系统上已安装 Python、pip、uv 和 Git（可选）。
设置 MCP 服务器 – 克隆仓库，配置环境并安装 MCP 服务器。
启用搜索控制台洞察 – 验证 MCP 服务器是否在 Claude Desktop 中正确运行，并开始使用高级搜索分析工具。

完成本指南后，Claude 将自动连接到 MCP 服务器，您可以轻松地运行查询、可视化数据并优化网站的搜索性能。让我们开始吧！🚀

🔹 您需要了解的内容

本教程旨在对初学者友好，您不需要任何高级技术技能。但是，您应该熟悉在命令行（也称为终端或命令提示符）中运行命令。

在整个指南中，您将输入类似以下的命令：

python --version
git clone <repository-url>

如果您从未使用过命令行，请不要担心！只需按照步骤操作即可。

这就是您需要的所有内容——让我们开始吧！🚀

🎯 第一部分 - 生成 JSON 凭证文件

按照这些步骤从 Google Cloud 控制台创建并下载一个服务账户 JSON 密钥。如果您已经有一个 JSON 凭证文件，可以跳过此部分。

📌 1. 转到 Google Cloud 控制台

🔗 访问 Google Cloud 控制台

📌 2. 选择您的项目

单击顶部的项目选择器。
选择一个现有项目或创建一个新项目。

如果您正在创建新项目：

启用搜索控制台 API

确保选择了新的项目
单击API和服务：
找到 Google 搜索控制台 API（您可能需要在顶部搜索）
单击**“启用”**
返回到仪表板（单击**“Google Cloud”**图标）

📌 3. 打开 IAM 和管理部分

在左侧菜单中，转到**“IAM 和管理” > “服务账户”**。

📌 4. 创建一个新的服务账户

单击**“创建服务账户”**。
输入一个名称（例如，my-app-service-account）。
单击**“创建并继续”**。

📌 5. 分配权限

选择一个角色（例如，编辑者，所有者）。
单击**“继续”**。

📌 6. 跳过授予用户访问权限（可选）

单击**“完成”**（无需添加用户）。

📌 7. 生成 JSON 密钥

在列表中找到您的服务账户。
单击右侧的三个点 (⋮) 并选择**“管理密钥”**。
单击**“添加密钥” > “创建新密钥”**。
选择**“JSON”格式并单击“创建”**。
✅ JSON 文件将自动下载。
复制 JSON 文件的路径（右键点击 + '复制为路径'）

📌 8. 将服务账户添加到 Google 搜索控制台

打开 Google 搜索控制台。
选择网站属性。
单击设置（左下角）。
在用户和权限下，单击添加用户。
输入服务账户电子邮件地址（来自第 4 步）。
分配权限：
- 受限（仅查看数据）。
- 完整（查看和管理属性）。
单击添加。

🎯 第二部分 - 安装所需工具

在开始处理项目之前，请确保已安装必要的工具。按照以下步骤检查是否一切就绪。

📌 1. 检查 Python 是否已安装

检查系统上是否已安装 Python，运行以下命令：

在 Windows 上：

python --version

在 Linux/macOS 上：

python3 --version

如果已安装 Python，您将看到版本号。如果没有，请从此处下载并安装：🔗 下载 Python

📌 2. 检查 pip 是否已安装

pip 是 Python 的包管理器。要检查是否已安装，运行以下命令：

在 Windows 上：

pip --version

在 Linux/macOS 上：

pip3 --version

如果未安装 pip，请遵循官方安装指南🔗 下载 pip

📌 3. 检查 uv 是否已安装

uv 是一个 Python 包和项目管理器。要检查是否已安装，运行以下命令：

在 Linux/macOS/Windows 上：

uv --version

如果未安装 uv，请遵循官方安装指南🔗 下载 uv

📌 4. 检查 Claude Desktop 是否已安装

如果未安装 Claude Desktop，请遵循官方安装指南🔗 下载 Claude Desktop 。

📌 5. 检查 Git 是否已安装（可选）

检查系统上是否已安装 Git，运行以下命令：

在 Linux/macOS/Windows 上：

git --version

如果已安装 Git，您将看到版本号。如果没有，您仍然可以下载程序文件，或者您可以从此处下载并安装 Git：🔗 下载 Git

🎯 第三部分 - 将 MCP 服务器添加到 Claude Desktop

设置说明

1. 克隆仓库

在文件将被下载到的文件夹中打开一个新的终端。运行以下命令：

git clone https://github.com/seotesting-com/gsc-mcp-server.git
cd gsc-mcp-server

如果您没有安装 Git：

下载 ZIP 文件：

2. 创建并激活虚拟环境

# Windows
uv venv
.venv\Scripts\activate

# macOS/Linux
uv venv
source .venv/bin/activate

3. 安装依赖项

# Windows/macOS/Linux
uv sync

4. 安装 MCP 服务器

添加 JSON 凭证文件的路径并运行以下命令：

mcp install server.py -v GOOGLE_APPLICATION_CREDENTIALS=<凭证文件路径>

请确保将 <凭证文件路径> 替换为您 JSON 凭证文件的实际路径，例如 C:\Users\Me\Downloads\credentials.json。

5. 重启 Claude Desktop

您可能需要在任务管理器中结束 Claude 任务。

🎯 第四部分 - 获取搜索控制台洞察

打开 Claude Desktop。如果 MCP 服务器已正确配置，您应该能够在聊天框中看到 5 个额外的工具可用：

您可以通过让 Claude 执行各种搜索控制台分析任务来使用这些工具。在调用工具之前，Claude 会询问您的许可。您应点击其中一个“允许”选项以使用 MCP 服务器：

开始提示

"列出我在 Google 搜索控制台中验证的所有站点"
"显示 example.com 从 2025 年 1 月 1 日到 1 月 31 日的搜索分析"
"比较 example.com 上个月与前一个月的搜索表现"
"过去 30 天内点击量最高的 10 个页面是什么？"
"显示过去 3 个月内每周的搜索趋势"

数据可视化提示

"生成过去一个月点击量最高的 5 个页面的条形图"
"创建过去 90 天内展示次数趋势的折线图"
"可视化移动设备和桌面流量之间的点击率对比"
"绘制 example.com 按国家划分的搜索表现热力图"
"创建按设备类型划分流量分布的饼图"
"生成对比点击率与位置的散点图，针对我的前 50 条查询"
"显示按搜索类型（网页、图片、视频）细分的流量来源的可视化"
"创建显示随时间变化的点击量和展示次数的堆积面积图"
"使用比较图表可视化周对周搜索表现的变化"
"生成多个图表的网站 SEO 表现可视化报告"

搜索控制台分析提示

"找出具有高展示次数但低点击率的关键词，我可以对其进行优化"
"显示在过去一个月内排名下降的页面"
"查找我的网站在过去 30 天内开始排名的新关键词"
"分析哪些移动页面与桌面相比存在最大的性能差距"
"显示我可以在第一页上推动的第 2 页（位置 11-20）上的查询"
"分析过去一年中搜索流量的季节性趋势"
"比较网站重新设计前后（3 月 1 日）的自然流量"
"根据展示次数与点击率，显示哪些国家具有最高的增长潜力"
"分析我的前 100 条查询的平均位置与点击率之间的相关性"
"基于潜在流量收益生成优先优化机会列表"

可用工具

list_sites

列出您 Google 搜索控制台帐户中的所有已验证站点。

query_search_analytics

参数：
- site_url: 您网站的完整 URL（例如，https://www.example.com/）
- start_date: 开始日期，YYYY-MM-DD 格式
- end_date: 结束日期，YYYY-MM-DD 格式
- dimensions: 维度列表（查询、页面、设备、国家、日期）
- search_type: 搜索结果类型（网页、图片、视频、新闻、发现、谷歌新闻）
- row_limit: 返回的行数（最大 25000）

compare_time_periods

参数：
- site_url: 您网站的完整 URL
- current_start_date: 当前时间段的开始日期，YYYY-MM-DD 格式
- current_end_date: 当前时间段的结束日期，YYYY-MM-DD 格式
- previous_start_date: 前一时间段的开始日期，YYYY-MM-DD 格式
- previous_end_date: 前一时间段的结束日期，  YYYY-MM-DD 格式
- dimensions: 维度列表（查询、页面、设备、国家、日期）
- search_type: 搜索结果类型
- row_limit: 返回的行数

get_top_performing_content

参数：
- site_url: 您网站的完整 URL
- start_date: 开始日期，YYYY-MM-DD 格式
- end_date: 结束日期，YYYY-MM-DD 格式
- metric: 排序依据的指标（点击量、展示次数、点击率、位置）
- limit: 返回的结果数量

get_search_trends

参数：
- site_url: 您网站的完整 URL
- start_date: 开始日期，YYYY-MM-DD 格式
- end_date: 结束日期，YYYY-MM-DD 格式
- interval: 分组的时间间隔（天、周、月）

🛠 故障排除

如果您在设置或使用 MCP 服务器时遇到任何问题，请尝试以下解决方案：

1️⃣ 重启 Claude Desktop

有时，工具不会立即出现。重启 Claude Desktop 并再次尝试。您可能需要在任务管理器（Windows）或活动监视器（Mac）中结束 Claude 进程后再重启。

2️⃣ 等待几分钟

设置 MCP 服务器后，新工具可能需要几分钟才能加载。如果它们没有立即出现，请等待几分钟再试一次。

3️⃣ 检查 JSON 凭证文件

确保服务账户 JSON 文件位于可访问的文件夹中。避免将其放在受限或管理员专用的文件夹中（例如，Windows 上的 C:\Program Files\ 或 macOS 上的 ~/Library/）。如有必要，请将其移至更易访问的位置，如您的文档或桌面上的文件夹。

:four: 检查 Claude 配置

转到文件 => 设置并点击开发者标签。当您点击搜索控制台分析时，它应显示状态为“运行”。如果不是，则可能存在错误消息，提供导致连接问题的详细信息。如果您看不到如下的设置，请确保您有最新版本的 Claude Desktop：🔗 下载 Claude Desktop。

点击编辑配置并打开文本编辑器中的**'claude_desktop_config.json'**。它应包含：

{
  "mcpServers": {
    "Search Console Analytics": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth",
        "--with",
        "mcp[cli]",
        "--with",
        "pandas",
        "mcp",
        "run",
        "C:\\Documents\\gsc-mcp-server\\server.py"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "C:\\Users\\Path\\To\\Credentials\\gscaccess-credentials.json"
      }
    }
  }
}

如果包含其他内容，请将此数据粘贴到文件中，并确保更新 server.py 文件和凭证文件的文件路径。确保转义反斜杠字符（如所示）。重启 Claude。

Mac 用户：解决“spawn uv ENOENT”错误

如果您在打开 Claude Desktop 时看到错误**“spawn uv ENOENT”**，这意味着 uv 未安装或未在系统路径中找到。如果已安装 uv，您可以尝试在 claude 配置中添加完整路径。

1️⃣ 更新 Claude Desktop 配置

打开Claude Desktop并转到文件 > 设置 > 开发者。点击**“搜索控制台分析”，然后选择编辑配置**。在claude_desktop_config.json中找到 "command": "uv" 条目。将 "uv" 替换为 uv 的完整路径，通常为：/Users/YOURUSERPROFILENAME/.local/bin/uv

运行以下命令以获取 uv 的安装路径：

which -a uv

此命令将显示您拥有的所有 uv 安装路径。如果您只能看到 /Library/Frameworks/Python.framework/Versions/3.**/bin/uv，则需要🔗 下载 uv 并返回到第三部分。

保存文件并重启 Claude Desktop。

2️⃣ 尝试另一种安装方法来安装 uv

如果上述方法不起作用，uv 可能未正确安装。尝试使用 Homebrew 安装：

brew install uv

如果您仍然遇到问题，请回顾您的步骤并确保一切设置正确。🚀