谷歌AI MCP服务器
一个模型上下文协议（MCP）服务器，通过Claude Desktop提供对谷歌人工智能模型的访问，包括Imagen 3、VEO 3、Gemini和Lyria。
🚀 快速开始
通过NPM安装（推荐）
添加到您的Claude Desktop配置中：
{
"mcpServers": {
"google-ai": {
"command": "npx",
"args": ["@stevekaplanai/google-ai-mcp@latest"],
"env": {
"USE_MOCK": "false",
"GOOGLE_CLOUD_PROJECT": "your-project-id",
"GOOGLE_CLOUD_LOCATION": "us-central1",
"GOOGLE_APPLICATION_CREDENTIALS_JSON": "{\"type\":\"service_account\",...}"
}
}
}
}✨ 特性
- 图3 -使用文本提示生成逼真的图像
- 我看到3 -创建5-8秒的音频视频（即将推出）
- 双子座 -访问谷歌最新的语言模型
- Lyria 2 -生成长达60秒的音乐（即将推出）
📋 先决条件
- 启用计费的谷歌云项目
- Vertex AI API已启用
- 具有适当权限的服务帐户
- 已安装Claude Desktop
🔧 安装说明
1.启用所需的API
gcloud services enable aiplatform.googleapis.com2.创建服务帐户
# Create service account
gcloud iam service-accounts create google-ai-mcp-server \
--display-name="Google AI MCP Server Service Account"
# Grant necessary permissions
gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
--member="serviceAccount:google-ai-mcp-server@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
--role="roles/aiplatform.user"
# Create and download key
gcloud iam service-accounts keys create service-account-key.json \
--iam-account=google-ai-mcp-server@YOUR_PROJECT_ID.iam.gserviceaccount.com3.配置克劳德桌面
更新您的Claude Desktop配置文件：
- 窗户：
%APPDATA%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"google-ai": {
"command": "npx",
"args": ["@stevekaplanai/google-ai-mcp@latest"],
"env": {
"USE_MOCK": "false",
"GOOGLE_CLOUD_PROJECT": "your-project-id",
"GOOGLE_CLOUD_LOCATION": "us-central1",
"GOOGLE_APPLICATION_CREDENTIALS_JSON": "paste-json-here"
}
}
}
}⚠️ 重要：粘贴JSON凭据时：
- 转义私钥中的所有换行符：
\n→\\n - 将整个JSON保存在一行中
- 不包括外部引号
4.重新启动克劳德桌面
更新配置后，完全重新启动Claude Desktop以使更改生效。
🎨 使用示例
生成图像
"Create a photorealistic image of a ninja duck in a dojo"生成多种变体
"Generate 4 variations of a cyberpunk city at night"不同的纵横比
"Create a 16:9 landscape image of mountains at sunset"
"Generate a 9:16 portrait image for a phone wallpaper"🛠️ 可用工具
imagen_generate_image
使用Google Imagen 3生成图像。
参数：
prompt（必填）：图像的文字描述aspectRatio：“1:1”（默认）、“16:9”、“9:16”、“4:3”、“3:4”sampleCount：1-8张图片（默认值：1）negativePrompt：这一代人应该避免什么personGeneration：“允许”（默认）或“不允许”
gemini_generate_text
使用Gemini模型生成文本。
参数：
prompt（必填）：输入文本提示model：“gemini-1.5-flash”（默认）、“gemini.1.5-pro”、“gemini-2.0-flash-exp”temperature：0-2（默认值：0.7）maxTokens：1-8192（默认值：2048）
veo_generate_video（即将推出）
使用VEO 3生成视频。
lyria_generate_music（即将推出）
使用Lyria 2生成音乐。
🧪 模拟模式
对于没有API调用的测试，请设置 USE_MOCK: "true" 在您的配置中。这将返回示例响应，而不使用您的Google Cloud配额。
🔍 故障排除
JSON解析错误
如果您看到“意外令牌”错误：
- 更新到最新版本：
@stevekaplanai/google-ai-mcp@latest - 重新启动克劳德桌面
身份验证错误
- 验证您的服务帐户是否具有
aiplatform.user角色 - 检查JSON凭据是否已正确转义
- 确保项目ID与您的服务帐户匹配
API找不到错误
- 确认Vertex AI API已在您的项目中启用
- 验证您使用的是受支持的位置（建议使用us-central1）
📊 支持的型号
图像
imagen-3.0-generate-001-最新高品质型号imagen-3.0-fast-generate-001-更快的一代
双子座
gemini-1.5-pro-最有能力的模型gemini-1.5-flash-速度优化gemini-2.0-flash-exp-实验特征
🔒 安全说明
- 从不将服务帐户密钥提交给版本控制
- 将环境变量用于生产部署
- 定期轮换服务帐户密钥
- 将服务帐户权限限制为所需的最小值
📝 更新日志
v1.0.2（最新）
- 通过将调试日志重定向到stderr修复JSON解析错误
- 改进了API响应的错误处理
- 增加了对真实Imagen API端点的支持
v1.0.1
- 模拟模式的初始版本
- 基本Imagen和Gemini支持
🤝 贡献
欢迎投稿！请看 贡献.md 作为指导方针。
📄 许可证
MIT许可证-请参阅 许可证 了解详情。
🙏 致谢
📧 支持
对于问题和疑问：
- GitHub问题： 谷歌ai mcp服务器/问题
- NPM包： @史蒂文·卡普兰/谷歌人工智能mcp
______________________________________________________________________
由以下材料制成❤️ 靠近 卡普兰