Gsc MCP Server

🚀 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

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