快速入门

前置条件

• Python 3.12 或更高版本
• Google 账户及 People API 启用的 Google Cloud 项目
• OAuth 2.0 凭据

安装方法

使用 uv（推荐）

1. 安装 uv：pip install uv
2. 克隆仓库：git clone https://github.com/rayanzaki/mcp-google-contacts-server.git
3. 创建虚拟环境并安装依赖：
   • uv venv
   • source .venv/bin/activate
   • uv pip install -r requirements.txt

使用 pip

1. 克隆仓库：git clone https://github.com/rayanzaki/mcp-google-contacts-server.git
2. 安装依赖：pip install -r requirements.txt

配置认证

提供 credentials.json 文件或设置环境变量：

• GOOGLE_CLIENT_ID
• GOOGLE_CLIENT_SECRET
• GOOGLE_REFRESH_TOKEN

启动服务

运行以下命令启动服务：

• 基础模式：python src/main.py
• HTTP 模式：python src/main.py --transport http --port 8080

更多参数详见 README 文档。