Skip to main content
Glama
enesjakozh

Gemini MCP Server for Claude Desktop

by Garblesnarff
npmGitHub
JavaScript
MIT License
14
14
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor Gemini MCP para Claude Desktop

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude Desktop generar imágenes utilizando los modelos de IA Gemini de Google.

🌟 Características

  • Genere imágenes directamente desde Claude Desktop utilizando los modelos Gemini de Google

  • Asistente de configuración fácil para la configuración

  • Parámetros de generación de imágenes personalizables

  • Integración con el sistema de servidor MCP de Claude Desktop

  • Capacidades detalladas de registro y depuración

  • Compatibilidad con Docker para una implementación y un uso compartido sencillos

📋 Requisitos

  • Node.js 16.x o superior

  • Aplicación de escritorio Claude

  • Clave API de Google Gemini ( Obtén una aquí )

  • Docker (opcional, para implementación en contenedores)

🚀 Instalación

Instalación global (recomendada)

npm install -g gemini-mcp-server # Run the setup wizard npx gemini-mcp-setup

Instalación local

# Create a directory for the server mkdir gemini-mcp-server cd gemini-mcp-server # Install locally npm install gemini-mcp-server # Run the setup wizard npx gemini-mcp-setup

Instalación de Docker

También puedes ejecutar el servidor Gemini MCP usando Docker:

# Build the Docker image docker build -t gemini-mcp-server . # Run the Docker container docker run -e GEMINI_API_KEY="your-api-key" -e OUTPUT_DIR="/app/output" -v /path/on/host:/app/output gemini-mcp-server

⚙️ Configuración

El asistente de configuración lo guiará a través del proceso de configuración:

  1. Ingresa tu clave API de Google Gemini

  2. Especifique el directorio para guardar las imágenes generadas

  3. Configurar los ajustes de registro y modelo

  4. Crear automáticamente un script contenedor para Claude Desktop

  5. Actualice la configuración de Claude Desktop

Si prefiere la configuración manual, consulte la sección Configuración manual a continuación.

🎨 Uso del servidor Gemini MCP

Una vez instalado y configurado, reinicie Claude Desktop para habilitar el servidor Gemini MCP. A continuación:

  1. Iniciar una conversación con Claude

  2. Pídele a Claude que genere una imagen para ti, por ejemplo:

    • Generar una imagen de un paisaje montañoso al atardecer.

    • "Crea una imagen de una ciudad futurista con coches voladores"

    • "Haz una ilustración de un gato tocando el piano"

Claude llamará a la API de Gemini para generar la imagen y proporcionarle la ruta al archivo de imagen guardado.

Opciones avanzadas

Puede personalizar la generación de imágenes con parámetros adicionales:

  • Estilo : especifique un estilo como "realista", "artístico", "minimalista", etc.

  • Temperatura : controla la creatividad/aleatoriedad de la generación (0,0-1,0)

Ejemplo: "Generar una imagen de una ciudad ciberpunk con luces de neón en un estilo realista con una temperatura de 0,7"

🔧 Configuración manual

Si prefiere no utilizar el asistente de configuración, siga estos pasos:

1. Crear archivo de configuración

Crea un archivo de configuración JSON con tus configuraciones:

{ "apiKey": "YOUR_GEMINI_API_KEY_HERE", "outputDir": "/path/to/your/output/directory", "debug": true, "modelOptions": { "model": "gemini-2.0-flash-exp", "temperature": 0.4 } }

2. Crear un script de envoltura

Cree un script bash para ejecutar el servidor:

#!/bin/bash # Set environment variables export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE" export OUTPUT_DIR="/path/to/your/output/directory" export DEBUG="true" # Execute the server exec "$(which node)" "$(npm root -g)/gemini-mcp-server/bin/gemini-mcp-server.js"

Hacer que el script sea ejecutable:

chmod +x gemini-mcp-wrapper.sh

3. Actualizar la configuración del escritorio de Claude

Edite su archivo ~/.config/claude/claude_desktop_config.json para agregar el servidor Gemini MCP:

{ "mcpServers": { "gemini-image": { "command": "/bin/bash", "args": [ "-c", "/path/to/your/gemini-mcp-wrapper.sh" ], "env": { "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE", "DEBUG": "true" } } } }

🐳 Implementación de Docker

Este servidor MCP incluye un Dockerfile para facilitar la implementación y el uso compartido. La imagen de Docker está configurada para:

  • Utilice Node.js 16 Alpine como base ligera

  • Instalar todas las dependencias necesarias

  • Configurar un directorio de salida predeterminado en /app/output

  • Permitir la configuración a través de variables de entorno

Construyendo la imagen de Docker

docker build -t gemini-mcp-server .

Ejecutando con Docker

docker run \ -e GEMINI_API_KEY="your-api-key" \ -e OUTPUT_DIR="/app/output" \ -e DEBUG="false" \ -v /path/on/host:/app/output \ gemini-mcp-server

Variables de entorno para Docker

Al ejecutar el contenedor Docker, puede configurar el servidor utilizando estas variables de entorno:

  • GEMINI_API_KEY : Su clave API de Google Gemini (obligatoria)

  • OUTPUT_DIR : Directorio para guardar las imágenes generadas (predeterminado: /app/output )

  • DEBUG : Habilitar el registro de depuración (predeterminado: false )

Uso con Claude Desktop

Al utilizar el contenedor Docker con Claude Desktop, necesitarás:

  1. Asegúrese de que el contenedor esté en ejecución

  2. Configurar Claude Desktop para conectarse al servidor contenedorizado

  3. Asigne el directorio de salida a una ubicación accesible para Claude

Documentación de la API

Interfaz de línea de comandos

gemini-mcp-server [options]

Opciones:

  • -k, --api-key <key> : clave de API de Google Gemini

  • -o, --output-dir <dir> : Directorio para guardar las imágenes generadas

  • -d, --debug : Habilitar el registro de depuración

  • -c, --config <path> : Ruta al archivo de configuración personalizado

  • -r, --reset-config : Restablecer la configuración a los valores predeterminados

  • -v, --version : Mostrar información de la versión

Variables de entorno

  • GEMINI_API_KEY : Su clave API de Google Gemini

  • OUTPUT_DIR : Directorio para guardar las imágenes generadas

  • DEBUG : Habilitar el registro de depuración ( true o false )

  • LOG_LEVEL : Establecer el nivel de registro ( ERROR , WARN , INFO o DEBUG )

  • GEMINI_LOG_FILE : Ruta del archivo de registro personalizado

Opciones de configuración

Opción

Descripción

Por defecto

apiKey

Clave API de Google Gemini

(requerido)

outputDir

Directorio para guardar las imágenes generadas

~/Claude/gemini-images

debug

Habilitar el registro de depuración

false

modelOptions.model

Modelo Géminis a utilizar

gemini-2.0-flash-exp

modelOptions.temperature

Controlar la creatividad/aleatoriedad

0.4

modelOptions.topK

Parámetro de muestreo top-k

32

modelOptions.topP

Parámetro de muestreo top-p

1

modelOptions.maxOutputTokens

Tokens de salida máxima

8192

🔍 Solución de problemas

Problemas comunes

El servidor no se inicia o Claude no puede conectarse a él

  1. Consulte el archivo de registro en ~/Claude/logs/gemini-image-mcp.log

  2. Verifique que su clave API sea correcta

  3. Asegúrese de que todos los directorios existan y tengan los permisos adecuados

  4. Reiniciar Claude Desktop

No se están generando imágenes

  1. Verifique que su clave API de Google Gemini tenga los permisos correctos

  2. Compruebe si el directorio de salida existe y se puede escribir

  3. Examinar los registros en busca de mensajes de error específicos

  4. Pruebe con un mensaje o modelo diferente

Error: "Método no encontrado"

Esto suele significar que Claude intenta llamar a un método que el servidor MCP no admite. Consulte los registros para ver qué método se solicitó.

Problemas específicos de Docker

  1. Asegúrese de que el contenedor tenga una conectividad de red adecuada

  2. Compruebe si los montajes de volumen están configurados correctamente

  3. Verificar que las variables de entorno estén configuradas correctamente

  4. Revisar los registros de contenedores con docker logs [container-id]

Modo de depuración

Habilite el modo de depuración para obtener registros más detallados:

npx gemini-mcp-server --debug

O bien establezca la variable de entorno:

export DEBUG=true npx gemini-mcp-server

📝 Licencia

Instituto Tecnológico de Massachusetts (MIT)

🙏 Agradecimientos

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Un servidor que permite a Claude Desktop generar imágenes utilizando los modelos de IA Gemini de Google a través del Protocolo de Contexto de Modelo (MCP).

  1. 🌟 Características
    1. 📋 Requisitos
      1. 🚀 Instalación
        1. Instalación global (recomendada)
        2. Instalación local
        3. Instalación de Docker
      2. ⚙️ Configuración
        1. 🎨 Uso del servidor Gemini MCP
          1. Opciones avanzadas
        2. 🔧 Configuración manual
          1. 1. Crear archivo de configuración
          2. 2. Crear un script de envoltura
          3. 3. Actualizar la configuración del escritorio de Claude
        3. 🐳 Implementación de Docker
          1. Construyendo la imagen de Docker
          2. Ejecutando con Docker
          3. Variables de entorno para Docker
          4. Uso con Claude Desktop
        4. Documentación de la API
          1. Interfaz de línea de comandos
          2. Variables de entorno
          3. Opciones de configuración
        5. 🔍 Solución de problemas
          1. Problemas comunes
          2. Modo de depuración
        6. 📝 Licencia
          1. 🙏 Agradecimientos

            Related MCP Servers

            • Gemini MCP Server

              aliargun
              -
              security
              -
              license
              -
              quality
              Model Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.
              Last updated -
              226
              MIT License
              • Apple
              • Linux

            • Gemini MCP Server

              palolxx
              -
              security
              -
              license
              -
              quality
              An MCP server implementation that allows using Google's Gemini AI models (specifically Gemini 1.5 Pro) through Claude or other MCP clients via the Model Context Protocol.
              Last updated -
              1

            • Gemini MCP Server

              dakrin
              -
              security
              -
              license
              -
              quality
              A Model Context Protocol server that enables Claude Desktop to interact with Google's Gemini 2.5 Pro Experimental AI model, with features like Google Search integration and token usage reporting.
              Last updated -
              3

            • MCP Gemini Server

              -
              security
              -
              license
              -
              quality
              An MCP server that enables other AI models (like Claude) to use Google's Gemini models as tools for specific tasks through a standardized interface.

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/Garblesnarff/gemini-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server