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

📋 Requisitos

Node.js 16.x o superior
Aplicación de escritorio Claude
Clave API de Google Gemini ( Obtén una aquí )

🚀 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

⚙️ Configuración

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

Ingresa tu clave API de Google Gemini
Especifique el directorio para guardar las imágenes generadas
Configurar los ajustes de registro y modelo
Crear automáticamente un script contenedor para Claude Desktop
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:

Iniciar una conversación con Claude
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

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

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

Consulte el archivo de registro en ~/Claude/logs/gemini-image-mcp.log
Verifique que su clave API sea correcta
Asegúrese de que todos los directorios existan y tengan los permisos adecuados
Reiniciar Claude Desktop

No se están generando imágenes

Verifique que su clave API de Google Gemini tenga los permisos correctos
Compruebe si el directorio de salida existe y se puede escribir
Examinar los registros en busca de mensajes de error específicos
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ó.

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

Protocolo de contexto de modelo para la especificación MCP
IA generativa de Google para la API de Gemini
Todos los contribuyentes a este proyecto

Gemini MCP Server for Claude Desktop

Integrations