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

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

🚀 快速开始

安装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

💻 使用示例

基础用法

在Claude Desktop中使用

• 步骤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
  

🔧 技术细节

故障排除

启动问题

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

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

权限问题

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

📄 注意事项

💡 使用建议

• 建议将配置文件和证书存放在非系统目录，如~/Documents或~/Desktop。
• 定期更新依赖库：

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

以上是完整的配置与使用指南。