Provides access to Google Cloud's Vertex AI services for generating images with Imagen 3/4 and creating videos with Veo 2/3, including batch processing, cost estimation, and campaign planning capabilities.
Enables AI-powered content generation using Gemini 2.5 Flash Image for creating various types of marketing content including social posts, blog intros, ad copy, email subjects, and product descriptions.
Content & Image Generation MCP Server
AI-powered content and image generation FastMCP server with Google Imagen 3/4 image generation, Veo 2/3 video generation, and Claude/Gemini content generation.
Production Ready: Deploy to FastMCP Cloud in 5 minutes!
Quick Links
5-Minute Deployment Guide - Get started fast
Complete Deployment Guide - Detailed instructions
Deployment Checklist - Ensure nothing is missed
Features
Tools
health_check - Server health and monitoring
Verify server health and API connectivity
Check service availability (Google AI, Anthropic)
Output directory validation
Perfect for monitoring deployments
generate_image_imagen3 - Generate high-quality marketing images
Google Imagen 3/4 integration
Multiple aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4)
1K and 2K resolution options
Negative prompts for better control
Production-ready with error handling
batch_generate_images - Generate multiple images efficiently
Batch processing for campaigns
Cost tracking across multiple images
Consistent quality and style
Detailed success/failure reporting
generate_video_veo3 - Create marketing videos
Google Veo 3 integration
Customizable duration (4, 6, 8 seconds)
720p and 1080p resolution
Native audio generation
Cost estimation per second
generate_marketing_content - AI-powered copywriting
Multiple content types (social posts, blog intros, ad copy, email subjects, product descriptions)
Choice of Claude Sonnet 4 or Gemini 2.5 Flash Image
Tone customization (professional, casual, enthusiastic, formal)
Length control (short, medium, long)
Optional hashtag generation
calculate_cost_estimate - Campaign budget planning
Detailed cost breakdown by service
Support for multiple models
Per-resource pricing
Campaign planning assistant
Resources
config://pricing - Current pricing for all services
config://models - Available AI models and capabilities
Prompts
campaign_planner - Interactive campaign planning assistant
image_prompt_enhancer - Optimize image generation prompts
Prerequisites
Python 3.10+ (required for FastMCP)
uv or pip package manager
Google Cloud Account with Vertex AI API enabled
Anthropic API Key (for Claude content generation)
Google AI API Key (for Gemini content generation)
Installation
1. Clone or Navigate to Project
2. Create Virtual Environment
Using uv (recommended):
Or using standard Python:
3. Install Dependencies
Using uv:
Or using pip:
For development with testing tools:
Configuration
1. Set Up Google Cloud
Create a Google Cloud project at https://console.cloud.google.com
Enable the Vertex AI API
Create a service account with Vertex AI permissions
Download the service account key JSON file
Set the path to your credentials file
2. Get API Keys
Anthropic: Get your API key from https://console.anthropic.com
Google AI: Get your API key from https://makersuite.google.com/app/apikey
3. Create Environment File
Copy the example environment file:
Edit .env with your configuration:
Important: Never commit the .env file with real credentials!
Usage
Local Development (STDIO for Claude Desktop)
Run the server in STDIO mode:
Or using FastMCP CLI:
HTTP Server for Deployment
Run the server in HTTP mode:
The server will start on http://0.0.0.0:8000
Claude Desktop Integration
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Note: Use absolute paths for both the server script and credentials file.
Example Usage
Generate a Marketing Image
Batch Generate Images for Campaign
Generate Marketing Copy
Estimate Campaign Costs
Pricing
Approximate costs (as of October 2025):
Service | Cost |
Imagen 3 SD | $0.020 per image |
Imagen 3 HD | $0.040 per image |
Imagen 4 SD | $0.025 per image |
Imagen 4 HD | $0.050 per image |
Veo 2 | $0.15 per second |
Veo 3 | $0.20 per second |
Claude Sonnet | $0.003 per 1K tokens |
Gemini Pro | $0.0005 per 1K tokens |
Use calculate_cost_estimate tool for detailed budget planning.
Output Directory
Generated content is saved to the output/ directory:
Images:
output/imagen3_YYYYMMDD_HHMMSS.pngVideos:
output/veo3_YYYYMMDD_HHMMSS.mp4
Security Best Practices
Never hardcode API keys - Always use environment variables
Use .env for local development - Never commit
.envto gitRotate credentials regularly - Especially for production use
Set up cost alerts - Monitor Google Cloud and Anthropic usage
Use service accounts with minimal permissions - Follow principle of least privilege
Deployment
FastMCP Cloud (Recommended)
Quick Deployment: Deploy to production in 5 minutes!
Visit: https://cloud.fastmcp.com
Sign in with GitHub
Create new project:
Repository:
vanman2024/content-image-generation-mcpEntrypoint:
server.py:mcp
Set environment variable:
GOOGLE_API_KEY=<your-key>Deploy
Your server will be available at:
Full Documentation:
Quick Start Guide - 5-minute deployment
Complete Deployment Guide - Detailed instructions
Deployment Checklist - Step-by-step checklist
Validation (optional but recommended):
Production Features
Your deployment includes:
✅ Structured logging with configurable levels
✅ Health check endpoint for monitoring
✅ Error handling and API validation
✅ Automatic redeployment on git push
✅ Zero-downtime deployments
✅ Cost tracking and estimation
IDE Integration
After deploying, connect from your IDE:
Claude Desktop (claude_desktop_config.json):
Cursor (.cursor/mcp_config.json):
Alternative Deployment Options
Local Development (STDIO):
HTTP Server:
Docker:
Build and run:
Troubleshooting
Import Errors
Google Cloud Authentication
API Key Issues
Development
Run Tests
Code Formatting
Add New Tools
Follow FastMCP patterns:
Resources
FastMCP Documentation: https://gofastmcp.com
Google Vertex AI: https://cloud.google.com/vertex-ai/docs
Anthropic Claude: https://docs.anthropic.com
Google Gemini: https://ai.google.dev
Support
For issues or questions:
Check the FastMCP documentation
Review Google Cloud Vertex AI docs
Verify API credentials and quotas
Check the
output/directory for generated files
License
Apache 2.0
Built with FastMCP 2.13.0 - The fast, Pythonic way to build MCP servers.