Gemini-cli 使用 Google Analytics MCP

安装环境: Ubuntu 20.04

由于需要提供给多人使用, 所以部署在云服务器上

1 安装 python >=3.10

由于analytics-mcp这个包要求python版本要大于等于3.10, 并且我当前的云服务器上的python版本是3.8, 所以需要安装较新版本的python, 我这里选择python3.11.

1.1 安装python3.11

bash 复制代码

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.11

1.2 设置python3.11为默认版本

bash 复制代码

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2
sudo update-alternatives --config python3
python3 --version

数字越大优先级越高, 所以上面的配置是优先python3.11

1.3 安装pip

bash 复制代码

wget https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py

1.4 安装pipx

bash 复制代码

python3 -m pip install --user pipx 
python3 -m pipx ensurepath
source ~/.bashrc

1.5 安装必要的包

bash 复制代码

sudo apt install python3.11-venv python3.11-distutils

2 Google 权限获取

2.1 Google Clouod Console

(1) 在Google Cloud Console新建一个项目, 保留一下Project ID, 等下要用到

(2) 启用Google Analytics Admin API和Google Analytics Data API

(3) 找到APIs&Services > Credentials, 选择Create Credentials > Service Account, 填写一下名称就可以了, optional的部分不用管.

(4) 进入创建的service account, 选择Keys >Add key > Create new key > Json, 会下载这个json格式的key, 保存好这个文件, 不要泄漏.

2.2 Google Analytics

(1) 打开Google Analytics, 选择Admin, 找到Property access management, 选Add User, 将刚才的json格式的key文件中的email地址添加进去, 权限为Viwer.

3 安装Gemini Cli

3.1 安装nodejs

bash 复制代码

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 安装nodejs v24
nvm install 24

3.2 安装Gemini Cli

bash 复制代码

npm install -g @google/gemini-cli

4 配置Google Analytics MCP

创建并编辑~/.gemini/settings.json文件

json 复制代码

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "analytics-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

PATH_TO_CREDENTIALS_JSON替换为刚才下载的json格式的key的位置
YOUR_PROJECT_ID替换为 Google Cloud Console 的项目ID

5 运行Gemini

登陆(需要外网环境)

使用 Google 账号登陆, 会跳出一个链接, 复制这个链接在本地的浏览器授权登陆就好了

测试MCP

如果MCP成功运行, 会提示这个, 然后就可以开始使用了

遇到的坑

(1) 需要python版本大于等于3.10

(2) ubuntu配置默认python版本的问题

(3) 需要安装python3.11-venv python3.11-distutils这两个包, 测试mcp服务能否顺利运行可以直接在命令行运行pipx run analytics-mcp 来测试.