MCP Search Console

mcp-search-console

面向运营人员的多账户 Google Search Console MCP 服务，让你无需重启服务，即可通过一个 MCP 接口管理多个网站或客户端。

发布状态：测试版软件包，版本为 pyproject.toml 中的 0.1.3。

选择你的路径

你要……	从这里开始	然后
将服务连接到 Claude/Codex/Cursor	docs/start-here.md	查看下方的快速入门
审查账户路由或破坏性操作防护	docs/architecture.md	gsc/server.py
审查打包方式或注册表元数据	pyproject.toml	server.json

架构

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  S --> M[Account manager]
  M --> F[Accounts config]
  M --> A[OAuth or service-account auth]
  S --> R[Retry wrapper]
  R --> G[Google Search Console API]
  G --> R --> S

请求流程

flowchart TD
  P[Operator asks for analytics or indexing data] --> T[Selected MCP tool]
  T --> A[Resolve named or default account]
  A --> B[Build authenticated GSC client]
  B --> C[Call Search Console endpoint]
  C --> D{API call succeeds?}
  D -- yes --> E[Return normalized JSON]
  D -- retryable --> F[Backoff and retry]
  F --> D
  D -- no --> G[Return error payload]

快速入门

1. 安装软件包。

python -m pip install mcp-search-console-multi

2. 创建账户配置。

mkdir -p ~/.config/mcp-search-console
cp accounts.example.json ~/.config/mcp-search-console/accounts.json

3. 在 MCP 客户端中注册。

{
  "mcpServers": {
    "search-console": {
      "command": "uvx",
      "args": ["mcp-search-console-multi"],
      "env": {
        "GSC_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-search-console/accounts.json"
      }
    }
  }
}

可用工具

工具组	工具	用途
账户路由	list_accounts、set_default_account、reauthenticate	查看账户、切换默认账户、刷新身份验证
资源清单	list_properties、get_site_details	查找可访问的资源和权限
搜索分析	get_search_analytics、get_performance_overview、compare_periods、get_advanced_search_analytics、get_search_by_page	查询搜索效果数据
检查与站点地图	inspect_url、batch_inspect_urls、check_indexing_issues、list_sitemaps、get_sitemap、submit_sitemap、delete_sitemap	检查索引并管理站点地图提交

submit_sitemap 和 delete_sitemap 受破坏性操作标志限制，详见 docs/start-here.md。

运行时证明

声明	证明
软件包入口稳定	pyproject.toml 中的 mcp-search-console-multi = "gsc.server:main"
多账户路由是一等功能	gsc/server.py 中的 AccountManager() 和 _get_manager()
Search Console 调用会重试	gsc/server.py 和 gsc/retry.py 中的 with_retry()
各账户的身份验证由文件配置	accounts.example.json 和 gsc/accounts.py

仓库目录

路径	用途
gsc/server.py	FastMCP 工具接口和响应规范化
gsc/accounts.py	账户配置、身份验证加载、客户端构建
gsc/auth/	OAuth 和服务账户身份验证实现
gsc/retry.py	针对瞬时 API 故障的重试行为
docs/start-here.md	设置、环境、验证、常见故障
docs/architecture.md	组件图和运行时生命周期

验证

检查项	命令
导入编译	python -m compileall gsc
软件包构建	python -m build
README/文档链接保持为本地链接	rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

许可证

MIT

新任务的项目背景

使用 INDEX.md 查找特定任务的约定；如果产品方向与任务相关，请参阅 prompt.md。历史示例不会决定当前任务。