Skip to main content
Glama
Sign In
enesjakozh

Gemini MCP Server for Claude Desktop

by Garblesnarff
GitHub
JavaScript
MIT License
1
OverviewInspectNewSchemaRelated 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ónDescripciónPor defecto
apiKeyClave API de Google Gemini(requerido)
outputDirDirectorio para guardar las imágenes generadas~/Claude/gemini-images
debugHabilitar el registro de depuraciónfalse
modelOptions.modelModelo Géminis a utilizargemini-2.0-flash-exp
modelOptions.temperatureControlar la creatividad/aleatoriedad0.4
modelOptions.topKParámetro de muestreo top-k32
modelOptions.topPParámetro de muestreo top-p1
modelOptions.maxOutputTokensTokens de salida máxima8192

🔍 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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

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

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. Crear archivo de configuración
          2. Crear un script de envoltura
          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
              A
              license
              -
              quality
              Model Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.
              Last updated -
              53
              TypeScript
              MIT License
              • Apple
              • Linux

            • Image Toolkit MCP Server

              Kira-Pgr
              -
              security
              A
              license
              -
              quality
              A server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.
              Last updated -
              6
              Python
              MIT License
              • Linux
              • Apple

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

            • MCP Gemini API Server

              techkwon
              -
              security
              F
              license
              -
              quality
              A server that provides access to Google Gemini AI capabilities including text generation, image analysis, YouTube video analysis, and web search functionality through the MCP protocol.
              Last updated -
              2
              TypeScript
              • Apple

            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