EA

eternnoir/aistudio-mcp-server

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

41 stars 6 forks Качество 55 Тренд 12

Google AI Studio MCP Server - мощная интеграция API Gemini для протокола Model Context с мультимодальной обработкой файлов, конверсией PDF-to-Markdown, анализом изображений и аудиотранскрипцией.

Обзор

Сервер Model Context Protocol (MCP), который интегрируется с Google AI Studio / Gemini API, предоставляя возможности генерации контента с поддержкой файлов, истории разговоров и системных подсказок. Node.js 20.0.0 или выше - ключ API Google AI Studio Установите ключ API Google AI Studio в качестве переменной среды: - 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 и текстовые файлы.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), который интегрируется с Google AI Studio / Gemini API, предоставляя возможности генерации контента с поддержкой файлов, истории разговоров и системных подсказок.

##Установка и использование

Предпосылки

Node.js 20.0.0 или выше Ключ Google AI Studio API

Использование npx (рекомендуется)

###Местная установка

Конфигурация

Установите ключ API Google AI Studio в качестве переменной среды:

Опциональная конфигурация

  • GEMINI_MODEL: Модель Близнецов для использования (по умолчанию: gemini-2.5-flash)
  • [[Т1]]: Запрос тайм-аута в миллисекундах (по умолчанию: 300000 = 5 минут)
  • [[Т2]]: Максимальный выход токенов (по умолчанию: 8192)
  • [[Т3]]: Максимальное количество файлов на запрос (по умолчанию: 10)
  • [[Т4]]: Максимальный общий размер файла в MB (по умолчанию: 50)
  • [[Т5]]: Температура для генерации (0-2, по умолчанию: 0.2)

Пример:

Доступные инструменты

###Создать контент

Генерирует контент с помощью Gemini с полной поддержкой файлов, истории разговоров и системных подсказок. Поддерживает различные типы файлов, включая изображения, PDF-файлы, документы Office и текстовые файлы.

Параметры:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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
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
Открыть полный README на GitHub

Установка

npx -y aistudio-mcp-server
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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