Google AI MCP Server

这是一个提供访问Google AI模型（包括Imagen 3、VEO 3、Gemini和Lyria）的Model Context Protocol (MCP)服务器，通过Claude Desktop进行访问。

🚀 快速开始

通过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\",...}"
      }
    }
  }
}

✨ 功能

• Imagen 3 - 使用文本提示生成逼真的图像
• VEO 3 - 创建带有音频的5-8秒视频（即将推出）
• Gemini - 访问Google最新的语言模型
• Lyria 2 - 生成长达60秒的音乐（即将推出）

📋 先决条件

1. 启用了计费功能的Google Cloud项目
2. 启用Vertex AI API
3. 具有适当权限的服务账户
4. 安装了Claude Desktop

🔧 设置说明

1. 启用所需API

gcloud services enable aiplatform.googleapis.com

2. 创建服务账户

# 创建服务账户
gcloud iam service-accounts create google-ai-mcp-server \
    --display-name="Google AI MCP Server Service Account"

# 授予必要的权限
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"

# 创建并下载密钥
gcloud iam service-accounts keys create service-account-key.json \
    --iam-account=google-ai-mcp-server@YOUR_PROJECT_ID.iam.gserviceaccount.com

3. 配置Claude Desktop

更新您的Claude Desktop配置文件：

• Windows: %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

更新配置后，请完全重启Claude Desktop以使更改生效。

🎨 使用示例

生成图像

"创建一只忍者鸭子在道馆的照片级真实图像"

生成多个变体

"生成4个夜晚的赛博朋克城市的变体"

不同的纵横比

"创建一个16:9的落日山景图像"
"生成一个9:16的手机壁纸肖像图像"

🛠️ 可用工具

imagen_generate_image

使用Google Imagen 3生成图像。

参数：

• prompt（必需）：图像的文字描述
• aspectRatio："1:1"（默认）、"16:9"、"9:16"、"4:3"、"3:4"
• sampleCount：1-8张图像（默认：1）
• negativePrompt：在生成过程中避免的内容
• personGeneration："allow"（默认）或"disallow"

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解析错误

如果您看到“意外的标记”错误：

1. 更新到最新版本：@stevekaplanai/google-ai-mcp@latest
2. 重启Claude Desktop

身份验证错误

• 验证您的服务账户具有aiplatform.user角色
• 检查JSON凭证是否正确转义
• 确保项目ID与您的服务账户匹配

API未找到错误

• 确认您的项目已启用Vertex AI API
• 验证您使用的是支持的位置（推荐us-central1）

📊 支持的模型

Imagen

• imagen-3.0-generate-001 - 最新的高质量模型
• imagen-3.0-fast-generate-_001 - 更快的生成

Gemini

• 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支持

🤝 贡献

欢迎贡献！请参阅CONTRIBUTING.md获取指南。

📄 许可证

MIT许可证 - 详情见LICENSE。

🙏 致谢

• 由Anthropic为Claude Desktop构建
• 使用Google的Vertex AI平台
• 实现Model Context Protocol

📧 支持

对于问题和疑问：

• GitHub Issues：google-ai-mcp-server/issues
• NPM 包：@stevekaplanai/google-ai-mcp

---

由Steve Kaplan用心制作