google-ai-mcp-server by Stevekaplanai - MCP Server

Google AI MCP Server

A Model Context Protocol (MCP) server that provides access to Google's AI models including Imagen 3, VEO 3, Gemini, and Lyria through Claude Desktop.

🚀 Quick Start

Install via NPM (Recommended)

Add to your Claude Desktop configuration:

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

✨ Features

Imagen 3 - Generate photorealistic images with text prompts
VEO 3 - Create 5-8 second videos with audio (coming soon)
Gemini - Access Google's latest language models
Lyria 2 - Generate up to 60 seconds of music (coming soon)

📋 Prerequisites

Google Cloud Project with billing enabled
Vertex AI API enabled
Service account with appropriate permissions
Claude Desktop installed

🔧 Setup Instructions

1. Enable Required APIs

gcloud services enable aiplatform.googleapis.com

2. Create Service Account

# 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.com

3. Configure Claude Desktop

Update your Claude Desktop config file:

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"
      }
    }
  }
}

⚠️ Important: When pasting the JSON credentials:

Escape all newlines in the private key: \n → \\n
Keep the entire JSON on one line
Don't include outer quotes

4. Restart Claude Desktop

After updating the configuration, completely restart Claude Desktop for changes to take effect.

🎨 Usage Examples

Generate an Image

"Create a photorealistic image of a ninja duck in a dojo"

Generate Multiple Variations

"Generate 4 variations of a cyberpunk city at night"

Different Aspect Ratios

"Create a 16:9 landscape image of mountains at sunset"
"Generate a 9:16 portrait image for a phone wallpaper"

🛠️ Available Tools

imagen_generate_image

Generate images using Google Imagen 3.

Parameters:

prompt (required): Text description of the image
aspectRatio: "1:1" (default), "16:9", "9:16", "4:3", "3:4"
sampleCount: 1-8 images (default: 1)
negativePrompt: What to avoid in the generation
personGeneration: "allow" (default) or "disallow"

gemini_generate_text

Generate text using Gemini models.

Parameters:

prompt (required): Input text prompt
model: "gemini-1.5-flash" (default), "gemini-1.5-pro", "gemini-2.0-flash-exp"
temperature: 0-2 (default: 0.7)
maxTokens: 1-8192 (default: 2048)

veo_generate_video (Coming Soon)

Generate videos with VEO 3.

lyria_generate_music (Coming Soon)

Generate music with Lyria 2.

🧪 Mock Mode

For testing without API calls, set USE_MOCK: "true" in your configuration. This will return sample responses without using your Google Cloud quota.

🔍 Troubleshooting

JSON Parsing Errors

If you see "Unexpected token" errors:

Update to the latest version: @stevekaplanai/google-ai-mcp@latest
Restart Claude Desktop

Authentication Errors

Verify your service account has the aiplatform.user role
Check that the JSON credentials are properly escaped
Ensure the project ID matches your service account

API Not Found Errors

Confirm Vertex AI API is enabled in your project
Verify you're using a supported location (us-central1 recommended)

📊 Supported Models

Imagen

imagen-3.0-generate-001 - Latest high-quality model
imagen-3.0-fast-generate-001 - Faster generation

Gemini

gemini-1.5-pro - Most capable model
gemini-1.5-flash - Optimized for speed
gemini-2.0-flash-exp - Experimental features

🔒 Security Notes

Never commit service account keys to version control
Use environment variables for production deployments
Regularly rotate service account keys
Limit service account permissions to minimum required

📝 Changelog

v1.0.2 (Latest)

Fixed JSON parsing errors by redirecting debug logs to stderr
Improved error handling for API responses
Added support for real Imagen API endpoints

v1.0.1

Initial release with mock mode
Basic Imagen and Gemini support

🤝 Contributing

Contributions are welcome! Please see for guidelines.

📄 License

MIT License - see for details.

🙏 Acknowledgments

Built for Claude Desktop by Anthropic
Uses Google's Vertex AI platform
Implements the Model Context Protocol

📧 Support

For issues and questions:

GitHub Issues: google-ai-mcp-server/issues
NPM Package: @stevekaplanai/google-ai-mcp

Made with ❤️ by Steve Kaplan

Stevekaplanai/google-ai-mcp-server