MCP Gsc

面向SEO的Google搜索控制台MCP服务器

连接的模型上下文协议（MCP）服务器 谷歌搜索控制台 （GSC）到人工智能助手，允许您通过自然语言对话分析您的SEO数据。适用于 克劳德桌面版, 光标, Codex CLI, Gemini CLI, 反重力，以及任何其他MCP兼容客户端。

更喜欢零设置？ 还有一个托管版本的MCP服务器，只需点击一下谷歌登录，没有Python，没有终端，并添加了GA4工具——可以在Claude.ai、ChatGPT、Cursor、Claude Desktop和任何MCP客户端中使用。 → 高级GSC MCP（托管） ·在创业初期，起价为每月12美元。

______________________________________________________________________

新增功能

\[0.3.2\]至2026年4月

• 为uvx修复了OAuth浏览器流 --删除了 isatty 阻止在macOS上作为MCP子进程运行时打开浏览器登录窗口的块。OAuth现在可以开箱即用 uvx，无需手动运行终端。
• get_capabilities 工具已添加 --调用此命令可一次性获取可用工具和当前身份验证状态的完整列表。当你的人工智能助手不确定有什么工具可用时，这很有用。
• 更好的身份验证错误消息 --现在，所有工具都会告诉您在凭据丢失或过期时该怎么办。

______________________________________________________________________

这能做什么？

物业管理

• 在一个地方查看您的所有GSC房产
• 获取验证详细信息和所有权信息
• 在您的帐户中添加或删除属性

搜索分析和报告

• 发现哪些查询会吸引访问者访问您的网站
• 跟踪展示、点击和点击率
• 分析性能趋势并比较时间段
• 使用AI助手创建的图表可视化数据

URL检查和索引

• 检查特定页面是否存在索引问题
• 查看谷歌上次抓取您的页面是什么时候
• 一次检查多个URL以识别模式

网站地图管理

• 查看所有站点地图及其状态
• 提交新的网站地图
• 检查错误或警告

______________________________________________________________________

可用工具

*让你的人工智能助手“调用get_capabilities”以获取所有20个工具的完整列表。*

______________________________________________________________________

______________________________________________________________________

入门指南

步骤1-设置Google API凭据

在配置任何客户端之前，您都需要凭据。选择一种方法：

选项A——OAuth（推荐——使用您自己的Google帐户）

1. 首选 谷歌云控制台 并创建或选择一个项目
2. 启用搜索控制台API
3. 首选 凭证 → 创建凭据→ OAuth客户端ID
4. 配置OAuth同意屏幕，选择 桌面应用，单击“创建”
5. 下载JSON文件——将其永久保存在某个地方（例如。 ~/Documents/client_secrets.json)

首次使用时，浏览器窗口将打开，要求您登录您的谷歌帐户。之后，令牌被保存，不再需要浏览器交互。

选项B——服务帐户（用于自动化或团队使用）

1. 首选 谷歌云控制台 并创建或选择一个项目
2. 启用搜索控制台API
3. 首选 凭证 → 创建凭据→ 服务帐户
4. 转到“密钥”选项卡→ 添加关键点→ 创建新密钥→ JSON → 下载
5. 将文件永久保存在某个地方（例如。 ~/Documents/service_account.json)
6. 将服务帐户电子邮件添加到您的GSC属性：Search Console→ 设置→ 用户和权限→ 添加用户→ 完全访问

🎥 观看本节的分步设置教程

*更新于2026年，涵盖了使用新的uvx方法的完整安装过程，从设置谷歌凭据到第一次成功查询。*

______________________________________________________________________

步骤2——安装

选项A-uvx（推荐）

没有克隆，没有Python安装，没有虚拟环境。 uvx 自动下载并运行服务器，并保持其最新状态。

安装uv --打开终端并按顺序运行所有三个命令：

# 1. Download and install
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Activate in the current Terminal session
source $HOME/.local/bin/env

# 3. Make it permanent for all future sessions
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

验证：

uv --version

为什么是这三个命令？ 安装程序将 uv 在 ~/.local/bin，但您已打开的终端会话尚不知道该文件夹。步骤2立即激活它。步骤3确保每个未来的终端窗口都自动拥有它。

现在配置您的AI客户端：

______________________________________________________________________

克劳德桌面版

配置文件： ~/Library/Application Support/Claude/claude_desktop_config.json

OAuth：

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

服务帐户：

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

______________________________________________________________________

光标

配置文件： ~/.cursor/mcp.json

OAuth：

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

______________________________________________________________________

Codex CLI

配置文件： ~/.codex/config.toml

OAuth：

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

服务帐户：

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_CREDENTIALS_PATH = "/full/path/to/service_account.json", GSC_SKIP_OAUTH = "true" }

______________________________________________________________________

找到你的uvx路径： 跑 which uvx 在终端安装紫外线后。在macOS上，它通常是 /Users/YOUR_NAME/.local/bin/uvx.更换 /FULL/PATH/TO/uvx 在上面的配置中，使用该路径。 为什么是全程？ Claude Desktop和Cursor等GUI应用程序无需读取shell配置即可启动(~/.zshrc)，所以他们不知道 ~/.local/bin。使用完整路径保证无论应用程序如何启动，它都能正常工作。如果你看到a spawn uvx ENOENT 错误，这是修复方法。

保存配置后， 完全退出应用程序(Cmd+Q)并重新打开它.

对于OAuth：首次使用时，浏览器窗口将自动打开进行登录。之后，令牌将被缓存，您将不会被再次询问。

______________________________________________________________________

选项B--克隆（高级）

您更喜欢这种方法的视频演练吗？ 下面的教程逐步介绍了克隆安装路径——虚拟环境设置、依赖关系和配置：

如果要修改代码或运行特定的本地版本，请使用此选项。此方法使用上面的视频教程进行凭据设置步骤。

克隆仓库：

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

或者从本页顶部的绿色“代码”按钮下载ZIP并解压缩。

设置环境：

uv venv .venv
uv pip install -r requirements.txt

配置您的AI客户端 （克劳德桌面示例）：

OAuth：

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

服务帐户：

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Mac路径示例：

• python /Users/yourname/Documents/mcp-gsc/.venv/bin/python
• 脚本： /Users/yourname/Documents/mcp-gsc/gsc_server.py

______________________________________________________________________

第3步——测试

问你的AI助手： “列出我的GSC属性”

如果你看到你的房产——它正在发挥作用。如果没有，问： “调用get_capabilities” 查看身份验证状态并诊断问题。

______________________________________________________________________

环境变量引用

______________________________________________________________________

Cursor市场

一键安装可用--搜索 mcp-search-console 在Cursor Marketplace上。

安装后，配置您的凭据（请参阅上面的步骤1），然后直接在Cursor Agent聊天中使用捆绑的技能：

______________________________________________________________________

示例提示

______________________________________________________________________

故障排除

spawn uvx ENOENT 或 command not found: uvx

您的AI客户端找不到 uvx.使用完整路径，而不是仅使用 uvx:

# Find your full path:
which uvx
# Typically: /Users/YOUR_NAME/.local/bin/uvx

替换 "command": "uvx" 和 "command": "/Users/YOUR_NAME/.local/bin/uvx" 在您的配置中。

uv --version 安装后立即给出“找不到命令”

安装程序正在更新 ~/.local/bin 但您当前的终端会话尚未看到它。运行：

source $HOME/.local/bin/env

然后将其永久添加：

echo 'source $HOME/.local/bin/env' >> ~/.zshrc

身份验证失败/找不到凭据文件

确保您正在使用 绝对路径 到您的凭据文件--不是相对路径，不是 ~/示例：

/Users/yourname/Documents/client_secrets.json   ✅
~/Documents/client_secrets.json                 ✅
client_secrets.json                              ❌

MCP仅适用于Claude Desktop应用程序，不适用于网站

MCP服务器在您的计算机上本地运行。它只适用于 Claude桌面应用程序 （下载自 claude.ai/下载)，不在claude.ai浏览器界面中。

AI客户端配置问题

1. 确保配置中的所有文件路径都是正确的绝对路径
2. 完全退出(Cmd+Q)并在任何配置更改后重新打开应用程序——仅仅关闭窗口是不够的
3. 让你的AI助手“调用get_capabilities”——它将报告确切的身份验证状态和错误

______________________________________________________________________

安全：破坏性操作

默认情况下， add_site, delete_site，以及 delete_sitemap 被禁用。要启用它们，请执行以下操作：

"GSC_ALLOW_DESTRUCTIVE": "true"

______________________________________________________________________

远程部署和Docker（高级）

标准设置在本地运行服务器。本节仅适用于希望在远程服务器或容器中运行它的用户。

HTTP传输

MCP_TRANSPORT=sse MCP_HOST=0.0.0.0 MCP_PORT=3001 python gsc_server.py

码头工人

docker build -t mcp-gsc .

docker run \
  -e MCP_TRANSPORT=sse \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3001 \
  -e GSC_CREDENTIALS_PATH=/app/credentials.json \
  -v /path/to/credentials.json:/app/credentials.json \
  -p 3001:3001 \
  mcp-gsc

______________________________________________________________________

相关工具

______________________________________________________________________

贡献

发现错误或有改进的想法？在GitHub上打开问题或提交拉取请求。

______________________________________________________________________

许可证

MIT许可证。看 许可证 文件以获取详细信息。

______________________________________________________________________

更新日志

\[0.3.2\]至2026年4月

• 为uvx修复了OAuth浏览器流 --已删除 isatty 阻止OAuth浏览器窗口在macOS上作为MCP子进程运行时打开的块。OAuth+ uvx 现在可以开箱即用了。
• get_capabilities 工具 --在一次调用中返回按类别分组的所有可用工具以及实时身份验证状态。
• 更好的身份验证错误消息 --所有工具现在都明确地告诉您调用 reauthenticate 当凭据丢失或过期时。
• 改进的 list_properties 描述 --在使用延迟工具加载的客户端中更好地发现语义工具。

\[0.3.1\]至2026年4月

• 固定的 list_properties 掩盖真实身份验证错误；缺少凭据会导致快速失败。

\[0.3.0\]至2026年4月

• Cursor Marketplace插件，包含4种捆绑的SEO技能
• 平台用户配置目录中的稳定令牌存储（幸存 uvx 升级）
• 所有数据工具的结构化JSON输出
• 39个单元测试

\[0.2.2\]至2026年4月

• 破坏性工具的安全模式（默认禁用）
• 用于远程部署的HTTP/SSE传输
• Dockerfile

\[0.2.1\]至2026年3月

• reauthenticate 切换Google帐户的工具
• 修复了站点地图类型错误崩溃
• 修复了域属性404错误

\[0.2.0\]至2026年3月

• dataState: "all" 默认情况下（与GSC仪表板匹配）
• 灵活的 row_limit 参数（最多500）
• 用于高级分析的多维过滤

\[0.1.0\]——首次发布

• 19个工具，涵盖物业管理、搜索分析、URL检查和站点地图管理
• OAuth和服务帐户身份验证