AI Studio MCP Server

A Model Context Protocol (MCP) server that integrates with Google AI Studio / Gemini API, providing content generation capabilities with support for files, conversation history, and system prompts.

- Node.js 20.0.0 or higher
- Google AI Studio API key

GEMINI_API_KEY=your_api_key npx -y aistudio-mcp-server

npm install -g aistudio-mcp-server GEMINI_API_KEY=your_api_key aistudio-mcp-server

Set your Google AI Studio API key as an environment variable:

- GEMINI_MODEL: Gemini model to use (default: gemini-2.5-flash)
- GEMINI_TIMEOUT: Request timeout in milliseconds (default: 300000 = 5 minutes)
- GEMINI_MAX_OUTPUT_TOKENS: Maximum output tokens (default: 8192)
- GEMINI_MAX_FILES: Maximum number of files per request (default: 10)
- GEMINI_MAX_TOTAL_FILE_SIZE: Maximum total file size in MB (default: 50)
- GEMINI_TEMPERATURE: Temperature for generation (0-2, default: 0.2)

export GEMINI_API_KEY=your_api_key_here export GEMINI_MODEL=gemini-2.5-flash export GEMINI_TIMEOUT=600000 # 10 minutes export GEMINI_MAX_OUTPUT_TOKENS=16384 # More output tokens export GEMINI_MAX_FILES=5 # Limit to 5 files per request export GEMINI_MAX_TOTAL_FILE_SIZE=100 # 100MB limit export GEMINI_TEMPERATURE=0.7 # More creative responses

Generates content using Gemini with comprehensive support for files, conversation history, and system prompts. Supports various file types including images, PDFs, Office documents, and text files.

- user_prompt(string, required): User prompt for generation
- system_prompt(string, optional): System prompt to guide AI behavior
- files(array, optional): Array of files to include in generation

- Each file object must have eitherpathorcontent
- path(string): Path to file
- content(string): Base64 encoded file content
- type(string, optional): MIME type (auto-detected from file extension)

Supported file types (Gemini 2.5 models):

- Images: JPG, JPEG, PNG, GIF, WebP, SVG, BMP, TIFF
- Video: MP4, AVI, MOV, WEBM, FLV, MPG, WMV (up to 10 files per request)
- Audio: MP3, WAV, AIFF, AAC, OGG, FLAC (up to 15MB per file)
- Documents: PDF (treated as images, one page = one image)
- Text: TXT, MD, JSON, XML, CSV, HTML

- Maximum file size: 15MB per audio/video/document file
- Maximum total request size: 20MB (2GB when using Cloud Storage)
- Video files: Up to 10 per request
- PDF files follow image pricing (one page = one image)

{ "user_prompt": "Analyze this image and describe what you see", "files": [ { "path": "/path/to/image.jpg" } ] }

{ "user_prompt": "Convert this PDF to well-formatted Markdown, preserving structure and formatting. Return only the Markdown content.", "files": [ { "path": "/path/to/document.pdf" } ] }

{ "system_prompt": "You are a helpful document analyst specialized in technical documentation", "user_prompt": "Please provide a detailed explanation of the authentication methods shown in this document", "files": [ {"path": "/api-docs.pdf"} ] }

{ "user_prompt": "Compare these documents and images", "files": [ {"path": "/document.pdf"}, {"path": "/chart.png"}, {"content": "base64encodedcontent", "type": "image/jpeg"} ] }

To convert PDF files to Markdown format, use thegenerate_contenttool with an appropriate prompt:

{ "user_prompt": "Convert this PDF to well-formatted Markdown, preserving structure, headings, lists, and formatting. Include table of contents if the document has sections.", "files": [ { "path": "/path/to/document.pdf" } ] }

Analyze images, charts, diagrams, or photos with detailed descriptions:

{ "system_prompt": "You are an expert image analyst. Provide detailed, accurate descriptions of visual content.", "user_prompt": "Analyze this image and describe what you see. Include details about objects, people, text, colors, and composition.", "files": [ { "path": "/path/to/image.jpg" } ] }

{ "user_prompt": "Describe this system architecture diagram. Explain the components and their relationships.", "files": [ { "path": "/architecture-diagram.png" } ] }

{ "system_prompt": "You are a professional transcription service. Provide accurate, well-formatted transcripts.", "user_prompt": "Please transcribe this audio file. Include speaker identification if multiple speakers are present, and format it with proper punctuation and paragraphs.", "files": [ { "path": "/meeting-recording.mp3" } ] }

{ "user_prompt": "Transcribe this interview and provide a summary of key points discussed.", "files": [ { "path": "/interview.wav" } ] }

Add this server to your MCP client configuration:

{ "mcpServers": { "aistudio": { "command": "npx", "args": ["-y", "aistudio-mcp-server"], "env": { "GEMINI_API_KEY": "your_api_key_here", "GEMINI_MODEL": "gemini-2.5-flash", "GEMINI_TIMEOUT": "600000", "GEMINI_MAX_OUTPUT_TOKENS": "16384", "GEMINI_MAX_FILES": "10", "GEMINI_MAX_TOTAL_FILE_SIZE": "50", "GEMINI_TEMPERATURE": "0.2" } } } }

Make sure you have Node.js 20.0.0 or higher installed.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

A command-line tool that summarizes code files in a directory using Gemini Flash 2.0.

Generate high-quality images from text prompts using Google's Gemini model.

Generate high-quality images using Google's Imagen 3.0 model via the Gemini API.

A server for integrating with the Google Gemini CLI to perform AI-powered tasks.

Generate images using Google's Imagen 3.0 model via the Gemini API.

AI image generation and editing MCP server. Text-to-image, text-based editing with iterative refinement. Multi-provider (Gemini + OpenAI).

A starter project with setup instructions and example MCP servers, including a weather server.

An AI-powered coding assistant that combines insights from Gemini, Stack Overflow, and Perplexity AI to help solve programming problems.

next-devtools-mcp is a MCP server that provides Next.js development tools and utilities for AI coding assistants like Claude and Cursor.