JinDaGe - gsc-mcp-server MCP Details

article

README

🚀 Google 搜索控制台分析服务器（MCP Server）在Claude Desktop上的配置指南

本指南详细介绍了如何在Claude Desktop上配置Google搜索控制台分析服务器（MCP Server），帮助你顺利使用相关功能。

🚀 快速开始

按照以下步骤，你可以逐步完成Google搜索控制台分析服务器（MCP Server）在Claude Desktop上的配置。

📦 安装指南

安装uv

运行以下命令安装uv：

pip install uv

🚀 配置步骤

下载并解压MCP服务端

访问GitHub仓库，下载并解压gsc-mcp-server.zip文件。

配置环境变量

编辑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",
        "/Users/YOUR_USER_NAME/Documents/gsc-mcp-server/server.py"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/YOUR_USER_NAME/Path/To/Credentials/gscaccess-credentials.json"
      }
    }
  }
}

⚠️ 重要提示

请将YOUR_USER_NAME和路径替换为实际路径。

启动服务

运行以下命令启动MCP服务器：

uv run --with google-api-python-client --with google-auth --with mcp[cli] --with pandas mcp run /path/to/server.py

💻 使用示例

使用说明

步骤1

在Claude Desktop中依次输入以下内容，按回车键执行。

! # Search Console Analytics

步骤2

系统会自动获取并显示搜索控制台的链接。将该链接复制到浏览器中打开，并按照提示接受权限请求。

工具介绍

搜索控制台链接生成器

输入以下命令生成搜索控制台的访问链接：

! # Search Console URL

数据获取工具

site-stats：获取网站统计数据。

! mcp site-stats --property-id YOUR_PROPERTY_ID

search-analytics：获取搜索分析数据。

! mcp search-analytics --property-id YOUR_PROPERTY_ID

🔧 故障排除

启动问题

如果出现启动错误，请检查以下事项：

确保uv已正确安装。
检查配置文件路径是否正确。

权限问题

如遇权限相关的问题，可能是服务账号缺乏所需的权限。请前往Google Cloud Console，为服务账号添加"Google Search Analytics（旧版）API Admin"角色。

📄 注意事项

💡 使用建议

建议将配置文件和证书存放在非系统目录，如~/Documents或~/Desktop。

定期更新依赖库：

pip install --upgrade uv google-api-python-client google-auth pandas

以上是完整的配置与使用指南，希望能帮助你顺利使用Google搜索控制台分析服务器（MCP Server）在Claude Desktop上的功能。

gsc-mcp-server