Conector MCP — Generación de imágenes con Gemini

Servidor MCP remoto en Node.js/TypeScript que expone la herramienta generate_image para que Claude (claude.ai) genere imágenes usando la API de Google Gemini.

Requisitos

1. API key de Google AI Studio: crea una gratis en https://aistudio.google.com/apikey

2. Node.js 20+ (para probar en local)

3. Una cuenta de hosting que soporte Node.js: Render, Railway, Fly.io o Google Cloud Run. Render tiene plan gratuito y es el más sencillo.

Related MCP server: Nano Banana MCP

Prueba en local

npm install
cp .env.example .env        # edita .env con tu API key
npm run dev

El endpoint queda en http://localhost:3000/mcp/TU_SECRETO (POST). Verifica salud en http://localhost:3000/health.

Puedes probarlo con MCP Inspector:

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP
# URL: http://localhost:3000/mcp/TU_SECRETO

Despliegue en Render (gratis)

1. Sube este proyecto a un repositorio de GitHub.

2. En https://render.com crea un Web Service apuntando al repo.

3. Configuración:

   • Build command: npm install && npm run build

   • Start command: npm start

   • Environment variables:

     • GEMINI_API_KEY = tu key de AI Studio

     • MCP_SECRET = un texto aleatorio largo (ej. genera uno con openssl rand -hex 12)

4. Render te da una URL tipo https://gemini-mcp-xxxx.onrender.com.

Tu endpoint MCP final será:

https://gemini-mcp-xxxx.onrender.com/mcp/TU_SECRETO

Nota: en el plan gratuito de Render el servicio "duerme" tras 15 min de inactividad; la primera petición puede tardar ~30-50 segundos en despertar.

Conectar en claude.ai

1. Ve a Configuración → Conectores (Settings → Connectors).

2. Clic en Agregar conector personalizado (Add custom connector).

3. Nombre: Gemini Imágenes — URL: tu endpoint MCP completo (con el secreto).

4. Guarda. Al iniciar un chat, activa el conector en el menú de herramientas.

5. Pídele a Claude: "Genera una imagen de un paisaje cafetero de Ebéjico al atardecer" — Claude llamará a generate_image y te mostrará el resultado.

Seguridad

• El MCP_SECRET en la ruta evita que cualquiera que descubra tu dominio consuma tu cuota de la API de Gemini. No lo compartas ni lo subas a GitHub (usa variables de entorno).

• La API key de Gemini nunca sale del servidor; Claude solo ve la herramienta.

• Si sospechas que el secreto se filtró, cámbialo en las variables de entorno y actualiza la URL del conector.

Cambiar de modelo

Por defecto usa gemini-2.0-flash-preview-image-generation. Si Google publica un modelo nuevo (o quieres usar Imagen), cambia la variable GEMINI_IMAGE_MODEL. Verifica los modelos disponibles para tu key en https://ai.google.dev/gemini-api/docs/models

Estructura

gemini-mcp/
├── src/index.ts        # Servidor Express + MCP + llamada a Gemini
├── package.json
├── tsconfig.json
└── .env.example