Q-CLI-INTEGRATION.md•1.92 kB
# GCP MCP 适配 Q CLI 完成
## 适配状态
✅ **完全兼容** - GCP MCP 服务器已成功适配 Q CLI
## 已完成的工作
### 1. 依赖安装和构建
- ✅ 安装所有 npm 依赖包
- ✅ TypeScript 编译成功
- ✅ 生成 dist/index.js 文件
### 2. 兼容性验证
- ✅ MCP SDK 加载正常
- ✅ Google Cloud 客户端库正常
- ✅ 所有核心依赖可用
### 3. Q CLI 配置文件
- ✅ 创建 `q-cli-config.json`
- ✅ 配置正确的执行路径和环境变量
## 使用方法
### 配置 Q CLI
将以下配置添加到你的 Q CLI 配置中：
```json
{
"mcpServers": {
"gcp-mcp": {
"command": "node",
"args": ["/Users/glei/genai/gcp-mcp/bin.js"],
"env": {
"NODE_PATH": "/Users/glei/genai/gcp-mcp/node_modules"
}
}
}
}
```
### 设置 GCP 认证
```bash
gcloud auth application-default login
```
### 可用工具
在 Q CLI 中可以使用以下工具：
- `gcp-mcp___run-gcp-code` - 执行 GCP 代码
- `gcp-mcp___list-projects` - 列出 GCP 项目
### 示例查询
- "列出我的所有 GCP 项目"
- "显示项目 X 中的 Cloud SQL 实例"
- "查看我的 GCP 账单状态"
- "列出 us-central1 区域的 GKE 集群"
## 技术细节
- **服务器类型**: 标准 MCP 服务器
- **通信协议**: stdio
- **支持的 GCP 服务**: Compute Engine, Cloud Storage, BigQuery, Cloud Functions, Cloud Run, GKE, Cloud SQL, Billing 等
- **认证方式**: Application Default Credentials (ADC)
## 文件结构
```
/Users/glei/genai/gcp-mcp/
├── bin.js # 入口脚本
├── index.ts # 主服务器代码
├── dist/index.js # 编译后的 JS 文件
├── q-cli-config.json # Q CLI 配置示例
├── README-Q-CLI.md # Q CLI 使用说明
└── Q-CLI-INTEGRATION.md # 本文件
```
## 状态总结
🎉 **GCP MCP 服务器已完全适配 Q CLI，可以直接使用！**