MewCP Google Gemini MCP

Servidor Gemini MCP alojado, sin estado y multiinquilino que permite a los asistentes de IA acceder a capacidades multimodales de IA, generación de contenido y flujos de razonamiento a través de Google Gemini.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Accede a los modelos de IA más capaces de Google a través de una única herramienta MCP.

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone la API de Google Gemini para generar texto utilizando modelos de lenguaje grandes de última generación.

Descripción general

El servidor MCP mewcp-gemini proporciona acceso directo a los LLM de Gemini de Google:

  • Genera respuestas de texto de alta calidad a partir de indicaciones en lenguaje natural
  • Elige entre variantes de modelos Gemini rápidas y capaces
  • Integra el razonamiento de Gemini en cualquier flujo de trabajo de IA compatible con MCP

Perfecto para:

  • Agentes de IA que necesitan delegar subtareas a un LLM potente
  • Generar resúmenes, traducciones, código o contenido creativo
  • Ampliar flujos de trabajo con las capacidades de razonamiento y lenguaje de Gemini

Herramientas

generate_text — Genera texto usando el LLM de Gemini

Genera texto usando el LLM de Gemini

Entradas:

- `query` (string, required) — Required. Natural language prompt to send to Gemini. Any text is accepted; no length limit is enforced by this tool.
- `model` (string, optional, default: gemini-2.5-flash) — Optional. Gemini model name, e.g., 'gemini-2.5-flash' or 'gemini-2.5-pro'. Defaults to 'gemini-2.5-flash'.

Esquema de salida data:

{
  prompt: string;
  response: string;
}

Referencia de parámetros de la API

Envoltorio de respuesta

Cada herramienta devuelve el mismo envoltorio de nivel superior. Solo data varía según la herramienta.

// Success
{
  "success": true,
  "statusCode": 200,
  "retriable": false,
  "retry_after_seconds": null,
  "error": null,
  "data": { ... }
}

// Error
{
  "success": false,
  "statusCode": 400,
  "retriable": false,
  "retry_after_seconds": null,
  "error": { "code": "{ERROR_CODE}", "message": "{description}", "details": {} },
  "data": null
}
  • retriable — true cuando es seguro reintentar (límite de velocidad, error de red, 503). false para errores de validación y autenticación.
  • retry_after_seconds — segundos de espera antes de reintentar; presente solo cuando retriable es true y el proveedor especifica un retraso.
  • error.code — cadena legible por máquina: VALIDATION_ERROR, AUTH_ERROR, UPSTREAM_ERROR, SERVER_ERROR.

Obtención de tu clave de API de Gemini

Pasos
  1. Ve a Claves de API de Google AI Studio
  2. Inicia sesión con tu cuenta de Google y navega a la sección de claves de API
  3. Haz clic en Crear clave de API
  4. Copia la clave generada: solo la verás una vez

Solución de problemas

Encabezados faltantes o no válidos
  • Causa: clave de API no proporcionada en los encabezados de la solicitud o formato incorrecto
  • Solución:
    1. Verifica que los encabezados Authorization: Bearer YOUR_API_KEY y X-Mewcp-Credential-Id: CREDENTIAL-ID estén presentes
    2. Comprueba que la clave de API esté activa en tu cuenta de MewCP
Créditos insuficientes
  • Causa: las llamadas a la API han superado tus límites de solicitudes
  • Solución:
    1. Revisa el uso de créditos en tu panel de Curious Layer
    2. Mejora a un plan de pago o añade créditos para límites más altos
    3. Contacta con el soporte para ajustes de créditos
Credencial no conectada
  • Causa: no hay ninguna credencial de Gemini vinculada a tu cuenta
  • Solución:
    1. Ve a Credenciales en tu panel de MewCP
    2. Añade tu clave de API (estática)
    3. Reintenta la solicitud con el encabezado X-Mewcp-Credential-Id correcto
Carga útil de solicitud malformada
  • Causa: la carga útil JSON no es válida o le faltan campos obligatorios
  • Solución:
    1. Valida la sintaxis JSON antes de enviar
    2. Asegúrate de que todos los parámetros de herramienta obligatorios estén incluidos
    3. Comprueba que los tipos de parámetros coincidan con los valores esperados
Servidor no encontrado
  • Causa: nombre de servidor incorrecto en el endpoint de la API
  • Solución:
    1. Verifica el formato del endpoint: mewcp-gemini/mcp/generate_text
    2. Usa el nombre de servidor correcto de la documentación
    3. Comprueba los servidores disponibles en tu cuenta de Curious Layer
Error de la API de Gemini
  • Causa: la API de Gemini ascendente devolvió un error
  • Solución:
    1. Comprueba el estado del servicio de Gemini en Página de estado de Google
    2. Verifica que tu credencial tenga los permisos necesarios
    3. Revisa el mensaje de error para obtener detalles específicos
Recursos