aminforou/mcp-gsc

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

2101 stars 273 forks 质量 87 趋势 44MIT

Repository Install

谷歌搜索控制台洞察与Claude AI用于SEO服务

概览

一个模型上下文协议（MCP）服务器，连接谷歌搜索控制台（GSC）与人工智能助手，允许您通过自然语言对话分析SEO数据。支持、、、及任何其他兼容MCP的客户端。更高级的托管版本——一键登录，新增了GA4工具。支持Claude Desktop、Claude Code、Claude.ai、Codex、Cursor及任何MCP客户端。仅支持。→ - — 移除了在macOS上作为MCP子进程运行时阻止浏览器登录窗口打开的isatty块。OAuth现在开箱即用，无需手动终端运行。- — 调用此功能一次性获取可用工具的完整列表和当前认证状态。当你的AI助手不确定有哪些工具可用时，非常有用。- — 所有工具现在都会准确告诉你当凭证缺失或过期时该怎么做。

概述（AI 翻译）

一个模型上下文协议（MCP）服务器，连接谷歌搜索控制台（GSC）与人工智能助手，允许您通过自然语言对话分析SEO数据。支持Claude Desktop、Cursor、Codex CLI、Gemini CLI、Antigravity及其他兼容MCP的客户端。

跳过设置，获取更多内容。 更高级的托管版本——一键登录，新增GA4工具。支持Claude Desktop、Claude Code、Claude.ai、Codex、光标及任何MCP客户端。仅100个座位。 → 高级GSC MCP（托管）

README

以下为原文 README 节选，完整内容请查看原文。

Google Search Console MCP Server for SEOs

A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and any other MCP-compatible client.

Skip setup, get more. A more advanced hosted version — one-click sign-in, added GA4 tools. Works with Claude Desktop, Claude Code, Claude.ai, Codex, Cursor, and any MCP client. Only 100 seats. → Advanced GSC MCP (hosted)

What’s New

[0.4.1] — September 2026

check_indexing_issues runs concurrently — same fix as #31, so it no longer times out on 10-URL batches against sc-domain:* properties. Thanks @kuldiph. (#55)
Removed a leftover dead orderBy in get_search_by_page_query (the Search Analytics API ignores it). Thanks @kuldiph. (#55)

[0.4.0] — September 2026

Rich-result issues now surface — inspect_url_enhanced and batch_url_inspection read rich-result issues from the correct API path, so markup problems are reported instead of silently dropped. Thanks @patrickweh. (#46, #48)
batch_url_inspection runs concurrently — 10-URL batches no longer time out on sc-domain:* properties. Thanks @remotesensei. (#31)
compare_search_periods deltas fixed — Period 1 is now the analyzed period and Period 2 the baseline, so growth reads as growth (not decline). Thanks @JKdreaming. (#42)
get_advanced_search_analytics sorting works — sort_by/sort_direction are now applied instead of silently ignored. Thanks @kuldiph. (#54)
Hardened error handling — replaced bare except: clauses so fatal signals aren’t swallowed. Thanks @kuldiph. (#53)
Note: batch_url_inspection renames the per-URL verdict field to index_verdict to distinguish it from the rich-result verdict.

[0.3.3] — July 2026

Fixed fresh installs broken by mcp 2.0 — pinned mcp[cli]<2.0.0. The mcp SDK 2.0.0 (released 2026-07-28) removed the mcp.server.fastmcp module, so every fresh uvx mcp-search-console install crashed on startup with ModuleNotFoundError: No module named 'mcp.server.fastmcp'. New installs now resolve a working 1.x SDK again — no --with "mcp<2" workaround needed.

[0.3.2] — April 2026

OAuth browser flow fixed for uvx — removed the isatty block that prevented the browser login window from opening when running as an MCP subprocess on macOS. OAuth now works out of the box with uvx, no manual terminal run needed.

在 GitHub 查看完整 README

安装

docker run \

新手？先看 mcpskill.org 教程 →

配置

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

aminforou/mcp-gsc

概览

概述（AI 翻译）

最新动态

[0.4.1] — 2026年9月

[0.4.0] — 2026年9月