Wingate SEO MCP

开源、自托管的 Google Search Console + Google Analytics 4 MCP 服务器，适用于 ChatGPT 和其他 MCP 客户端。无需再为另一个 SEO 仪表板付费，即可分析您自己的 SEO 数据。

Wingate SEO MCP 将 MCP 客户端连接到您已拥有的 Google 资源。它在一个只读服务中整合了 Search Console 效果数据、GA4 互动、站点地图与网址检查（URL Inspection）证据、周期对比以及确定性的 SEO 诊断。

发布者：Wingnut Innovations
版本：0.5.0
许可证：MIT

为什么使用它？

• 用自然语言查询您自己的 GSC 和 GA4 数据。

• 将凭据和资源映射保存在您控制的基础设施上。

• 用可复现的证据和计算取代重复的仪表板工作。

• 检查事件活动、着陆页互动、CTR 机会、排名变化、衰减和自相蚕食。

• 从刻意收窄的只读安全边界开始。

您自行提供 Google 凭据，并仅授予该身份访问您要分析的资源的权限。Wingate SEO MCP 不包含托管账户、捆绑的 Google 访问权限、付费门槛、遥测、广告或订阅。

只读 MCP 工具

公共服务器恰好公开 11 个工具：

公开候选版本中不包含 Search Console、Google Indexing、GA4 Admin、站点地图提交或其他写入工具。

环境要求

• Node.js 20、22 或 24

• npm

• 一个已启用所需 API 的 Google Cloud 项目

• 用户自行提供的 Google 服务账号 JSON 凭据，且具有对您的 GSC 和 GA4 资源的访问权限

• 能够访问本地 Streamable HTTP 端点的 MCP 客户端

快速开始

git clone https://github.com/wingnutinnovations-tech/wingate-seo-mcp.git
cd wingate-seo-mcp
npm install

以 .env.example 为模板，并在启动命令所在的 shell 中设置相同的环境变量。项目不会自动加载 .env。请将下载的服务账号 JSON 保存在仓库之外。

GOOGLE_SERVICE_ACCOUNT_FILE=/absolute/path/to/google-service-account.json
WINGATE_SITES_FILE=./config/sites.local.json

由 npm start 启动的 v0.5.0 MCP 运行时需要显式提供服务账号凭据。请设置 GOOGLE_SERVICE_ACCOUNT_FILE（首选）、GOOGLE_APPLICATION_CREDENTIALS 或 GOOGLE_SERVICE_ACCOUNT_JSON。它不会回退到附加的 Google Cloud 元数据/工作负载身份。

验证凭据并发现可访问的资源：

npm run doctor
npm run discover:google

使用发现流程返回的资源生成一份会被忽略的本地站点注册表：

npm run setup -- --output config/sites.local.json \
  --gsc sc-domain:example.com \
  --ga4 123456789 \
  --origin https://example.com \
  --key example-site \
  --name "Example Site"

先运行有界的实时读取，再启动服务器：

npm run live:smoke -- --site example-site --inspect-origin
npm start

默认端点为：

http://127.0.0.1:3000/healthz
http://127.0.0.1:3000/mcp

有关详细的分步指南，请参阅 Google 设置 和 实时接入。

Google API 设置

在您的 Google Cloud 项目中启用以下 API：

• Google Search Console API

• Search Console URL Inspection API

• Google Analytics Data API

• Google Analytics Admin API

为服务账号的电子邮件授予对每个 Search Console 资源的访问权限，并至少授予对每个 GA4 资源的查看者（Viewer）访问权限。运行时仅请求：

• https://www.googleapis.com/auth/webmasters.readonly

• https://www.googleapis.com/auth/analytics.readonly

Analytics Admin API 仅用于发现可访问的 GA4 资源和数据流。MCP 服务器不会修改 GA4 Admin 设置。

站点映射

每个本地注册表条目都将一个稳定的 siteKey 映射到一个 Search Console 资源、一个可选的 GA4 资源以及站点的来源（origin）。如需了解条目格式，请复制 config/sites.example.json，或让 npm run setup 生成并验证 config/sites.local.json。

本地注册表会被 Git 忽略。如果仓库读者不应知道您运营哪些站点，切勿提交真实的资源映射。

连接 MCP 客户端

启动服务器，将支持 Streamable HTTP 的 MCP 客户端指向本地的 /mcp 端点。请使用客户端支持的本地连接，或经过独立审查的传输边界。本仓库不附带互联网隧道或身份验证层。

在发送数据之前，请检查工具发现结果，确认恰好有 11 个工具，并且每个工具都标记为只读。请参阅 MCP 客户端连接。

示例问题

• “本月哪些页面丢失了点击？”

• “找出排名 4–20 且 CTR 较弱的查询。”

• “哪些自然搜索着陆页的互动表现最佳？”

• “我的潜在客户事件是否触发了？”

• “将最近 28 天与之前 28 天进行比较。”

隐私与安全

Wingate SEO MCP 没有任何未披露的遥测。它不会向 Wingnut Innovations 或任何第三方发送使用分析数据。

数据仅在以下情况下才会离开您的机器或服务器：

• 连接器使用您配置的凭据和资源访问权限调用 Google API；或

• 您配置的 MCP 客户端向此服务器发送请求并从其接收结果。

默认情况下，服务器绑定到 127.0.0.1。在添加经过独立审查的身份验证和传输边界之前，请勿将其直接暴露到公共互联网。请勿将凭据、本地注册表或命令输出放入提示词或源代码管理中。请参阅 SECURITY.md。

故障排查

• 凭据文件无法读取： 请使用绝对路径，并将 JSON 文件保存在仓库之外。

• Google 返回 403： 请启用相关 API，并授予服务账号的电子邮件对该资源的访问权限。

• 未找到 GA4 资源： 请至少授予查看者（Viewer）访问权限，然后重新运行 npm run doctor。

• 映射不明确： 请显式提供 --ga4；发现流程绝不会在静默中选择弱匹配项。

• 无事件行： GA4 在该日期/筛选范围内未观察到匹配的行；仅凭缺失并不能诊断埋点问题。

• MCP 客户端无法连接： 请确认 npm start、/healthz、回环绑定，以及客户端的本地网络或另行保护的传输配置。

开发与验证

npm run ci

这会运行语法检查、TypeScript 检查、单元/集成测试、生产构建和 MCP 发现。CI 面向 Node.js 20、22 和 24。

Docker 打包被有意推迟，直到准备好小巧、可审查的镜像和非 root 运行时策略；Node/npm 自托管路径是 v0.5.0 的基线方案。

路线图与支持

请参阅路线图。Wingate SEO MCP 完全免费且开源。如果它为您节省了时间或一份 SEO 工具订阅费用，您可以选择支持持续开发。v0.5.0 未配置任何资助方。

许可证、来源与独立性

Wingate SEO MCP 依据 MIT 许可证 授权。部分 Google 客户端和方法映射改编自在 UPSTREAM.md、UPSTREAM_IMPORT_MANIFEST.json 和 THIRD_PARTY_NOTICES.md 中记录的固定版本、MIT 许可的上游项目，并进行了大幅重写。

Wingate SEO MCP 是由 Wingnut Innovations 发布的独立项目。它不隶属于 Google 或 OpenAI，也未获得其认可或资助。Google Search Console、Google Analytics、GA4、ChatGPT 和 OpenAI 均为其各自所有者的商标。