MewCP Google Gemini MCP

Servidor Gemini MCP hospedado, sem estado e multilocatário que permite que assistentes de IA acessem capacidades multimodais de IA, geração de conteúdo e fluxos de raciocínio através do Google Gemini.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Acesse os modelos de IA mais capazes do Google por meio de uma única ferramenta MCP.

Um servidor Model Context Protocol (MCP) que expõe a API do Google Gemini para gerar texto usando modelos de linguagem de grande porte de última geração.

Visão Geral

O servidor MCP mewcp-gemini fornece acesso direto aos LLMs Gemini do Google:

  • Gere respostas de texto de alta qualidade a partir de prompts em linguagem natural
  • Escolha entre variantes de modelos Gemini rápidas e capazes
  • Integre o raciocínio do Gemini a qualquer fluxo de trabalho de IA compatível com MCP

Perfeito para:

  • Agentes de IA que precisam delegar subtarefas a um LLM poderoso
  • Gerar resumos, traduções, código ou conteúdo criativo
  • Aumentar fluxos de trabalho com as capacidades de raciocínio e linguagem do Gemini

Ferramentas

generate_text — Gere texto usando o Gemini LLM

Gere texto usando o Gemini LLM

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'.

Saída data esquema:

{
  prompt: string;
  response: string;
}

Referência de Parâmetros da API

Envelope de Resposta

Cada ferramenta retorna o mesmo envelope de nível superior. Apenas data varia por ferramenta.

// 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 quando é seguro tentar novamente (limite de taxa, erro de rede, 503). false para erros de validação e autenticação.
  • retry_after_seconds — segundos para aguardar antes de tentar novamente; presente apenas quando retriable é true e o upstream especifica um atraso.
  • error.code — string legível por máquina: VALIDATION_ERROR, AUTH_ERROR, UPSTREAM_ERROR, SERVER_ERROR.

Obtendo Sua Chave de API do Gemini

Passos
  1. Acesse Google AI Studio API Keys
  2. Entre com sua conta do Google e navegue até a seção de chaves de API
  3. Clique em Create API Key
  4. Copie a chave gerada — você só a verá uma vez

Solução de Problemas

Cabeçalhos Ausentes ou Inválidos
  • Causa: chave de API não fornecida nos cabeçalhos da solicitação ou formato incorreto
  • Solução:
    1. Verifique se os cabeçalhos Authorization: Bearer YOUR_API_KEY e X-Mewcp-Credential-Id: CREDENTIAL-ID estão presentes
    2. Verifique se a chave de API está ativa na sua conta MewCP
Créditos Insuficientes
  • Causa: as chamadas de API excederam seus limites de solicitação
  • Solução:
    1. Verifique o uso de créditos no seu painel Curious Layer
    2. Atualize para um plano pago ou adicione créditos para limites maiores
    3. Entre em contato com o suporte para ajustes de crédito
Credencial Não Conectada
  • Causa: nenhuma credencial Gemini vinculada à sua conta
  • Solução:
    1. Vá para Credenciais no seu painel MewCP
    2. Adicione sua chave de API (estática)
    3. Tente novamente a solicitação com o cabeçalho X-Mewcp-Credential-Id correto
Payload de Solicitação Malformado
  • Causa: o payload JSON é inválido ou está faltando campos obrigatórios
  • Solução:
    1. Valide a sintaxe JSON antes de enviar
    2. Garanta que todos os parâmetros obrigatórios da ferramenta estejam incluídos
    3. Verifique se os tipos de parâmetros correspondem aos valores esperados
Servidor Não Encontrado
  • Causa: nome de servidor incorreto no endpoint da API
  • Solução:
    1. Verifique o formato do endpoint: mewcp-gemini/mcp/generate_text
    2. Use o nome de servidor correto da documentação
    3. Verifique os servidores disponíveis na sua conta Curious Layer
Erro da API Gemini
  • Causa: a API Gemini upstream retornou um erro
  • Solução:
    1. Verifique o status do serviço Gemini em Google Status Page
    2. Verifique se sua credencial tem as permissões necessárias
    3. Revise a mensagem de erro para obter detalhes específicos
Recursos