Google Search Console MCP Server

Google Search Console MCP 服务

用于通过模型上下文协议（MCP）服务访问 Google Search Console 的工具。

功能

• 检索搜索分析数据（支持维度）
• 通过自定义报告时间段进行详细的数据分析

先决条件

• Python 3.10 或更高版本
• 已启用 Search Console API 的 Google Cloud 项目
• 有权访问 Search Console 的服务账号凭据

安装

pip install mcp-server-google-search-console

或从源代码安装：

git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .

设置开发环境（uv）

本项目使用 uv 来加快包管理和安装。

安装 uv 和 uvx

首先，安装 uv 和 uvx：

pip install uv uvx

创建和管理虚拟环境

使用 uv 创建新的虚拟环境：

uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows

安装依赖项

克隆代码库后，安装依赖项：

git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .

单独安装 MCP 包：

pip install "mcp[cli]"

安装开发依赖项

若要安装开发所需的其他工具，请运行：

pip install -e ".[dev]"

身份验证设置

获取 Google Search Console API 凭据：

1. 访问 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 API：
   • 前往“APIs & Services” > “Library”
   • 搜索并启用“Search Console API”
4. 创建凭据：
   • 前往“APIs & Services” > “Credentials”
   • 点击“Create Credentials” > “Service Account”
   • 输入服务账号详细信息
   • 创建一个 JSON 格式的新密钥
   • 凭据文件（.json）将自动下载
5. 授予访问权限：
   • 打开 Search Console
   • 将服务账号邮箱地址（格式：[email protected]）添加为媒体资源管理员

使用方法

设置环境变量，以指定 Google Search Console 凭据文件的路径：

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json

启动 MCP 服务

标准方法

mcp-server-gsc

使用 uvx

使用 uvx 可自动完成虚拟环境和包的安装：

# Run directly without installation
uvx run mcp-server-gsc

# Run with a specific Python version
uvx --python=3.11 run mcp-server-gsc

# Run with specified environment variables
uvx run -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json mcp-server-gsc

Claude Desktop 应用配置

标准配置

{
  "mcpServers": {
    "gsc": {
      "command": "mcp-server-gsc",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

使用 uvx 配置

{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": ["run", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

可用工具

search_analytics

从 Google Search Console 检索搜索效果数据：

必需参数：

• siteUrl：网站 URL（格式：http://www.example.com/ 或 sc-domain:example.com）
• startDate：开始日期（YYYY-MM-DD）
• endDate：结束日期（YYYY-MM-DD）

可选参数：

• dimensions：以逗号分隔的列表（query,page,country,device,searchAppearance）
• type：搜索类型（web、image、video、news）
• aggregationType：聚合方法（auto、byNewsShowcasePanel、byProperty、byPage）
• rowLimit：返回的最大行数（默认：1000）

使用示例：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

发布流程

创建 GitHub 发布标签时，本项目会自动发布到 PyPI。

发布新版本：

1. 运行版本更新脚本：

   python scripts/bump_version.py [major|minor|patch]
   

2. 按照显示的说明推送到 GitHub：

   git add pyproject.toml
   git commit -m "Bump version to x.y.z"
   git tag vx.y.z
   git push origin main vx.y.z
   

3. 在 GitHub 代码库页面创建发布：

   • 选择标签：vx.y.z
   • 输入标题：vx.y.z
   • 填写发布说明
   • 点击“Publish”

4. GitHub Actions 将被触发，并自动将包发布到 PyPI。

许可证

MIT

贡献

欢迎贡献！提交拉取请求前，请阅读贡献指南。