Google AI Studio / Gemini API와 통합 된 Model Context Protocol (MCP) 서버는 파일, 대화 기록 및 시스템 프롬프트를 지원하는 콘텐츠 생성 기능을 제공합니다.

임명과 사용법

# 필수품

• Node.js 20.0.0 이상
• Google AI Studio API 키

npx 사용 (추천)

# 현지 설치

구성

환경 변수로 Google AI Studio API 키 설정:

옵션 구성

• GEMINI_MODEL: Gemini 모델 사용 (기본값: gemini-2.5-flash)
• GEMINI_TIMEOUT: 밀리 초에 타임 아웃 요청 (기본값 : 300000 = 5 분)
• GEMINI_MAX_OUTPUT_TOKENS: 최대 출력 토큰 (과태: 8192)
• GEMINI_MAX_FILES: 요청에 의하여 파일의 최대 수 (과태: 10)
• GEMINI_MAX_TOTAL_FILE_SIZE: MB (과태: 50)에 있는 최대 총 파일 크기
• GEMINI_TEMPERATURE: 세대의 온도 (0-2, 기본값: 0.2)

예:

사용 가능한 도구

생성하기

Gemini를 사용하여 컨텐츠를 생성하여 파일, 대화 기록 및 시스템 프롬프트에 대한 종합적인 지원을 제공합니다. 이미지, PDF, Office 문서 및 텍스트 파일을 포함한 다양한 파일 형식을 지원합니다.

** 모수: **

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.

Installation and Usage

Prerequisites

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

Using npx (Recommended)

GEMINI_API_KEY=your_api_key npx -y aistudio-mcp-server

Local Installation

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

Configuration

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

export GEMINI_API_KEY=your_api_key_here

Optional Configuration

• 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)

Example:

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

Available Tools

generate_content

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.

Parameters:

• 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 either path or content
  • path (string): Path to file
  • content (string): Base64 encoded file content
  • type (string, optional): MIME type (auto-detected from file extension)
• model (string, optional): Gemini model to use (default: gemini-2.5-flash)
• temperature (number, optional): Temperature for generation (0-2, default: 0.2). Lower values produce more focused responses, higher values more creative ones

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

File limitations:

• 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