Gemini MCP Server

Um servidor MCP para interagir com os modelos de IA Gemini do Google, exigindo uma chave de API Gemini.

Documentação

Gemini MCP Server

Um poderoso servidor MCP (Model Context Protocol) que traz os modelos de IA Gemini mais recentes do Google para o seu ambiente de desenvolvimento favorito. Acesse os recursos de raciocínio do Gemini 2.5, análise de visão, embeddings e muito mais por meio de uma integração perfeita.

🚀 Funciona com: Claude Desktop, Cursor, Windsurf e qualquer cliente compatível com MCP
🎯 Por que usar: Obtenha os recursos de IA de ponta do Gemini diretamente na sua IDE com controle total de parâmetros
📚 Autodocumentável: Sistema de ajuda integrado significa que você nunca precisa sair do seu editor

Recursos

6 Ferramentas Poderosas: Geração de texto, análise de imagens, contagem de tokens, listagem de modelos, embeddings e ajuda autodocumentável
Modelos Gemini Mais Recentes: Suporte para a série Gemini 2.5 com recursos de raciocínio
Recursos Avançados: Modo JSON, grounding com Google Search, instruções de sistema, memória de conversa
Protocolo MCP Completo: Comunicação stdio padrão para integração perfeita com qualquer cliente MCP
Autodocumentável: Sistema de ajuda integrado - sem necessidade de documentação externa
TypeScript & ESM: Implementação moderna e type-safe

Modelos Suportados

Modelo	Contexto	Recursos	Melhor Para
gemini-2.5-pro	2M tokens	Thinking, JSON, Grounding	Raciocínio complexo
gemini-2.5-flash ⭐	1M tokens	Thinking, JSON, Grounding	Uso geral
gemini-2.5-flash-lite	1M tokens	Thinking, JSON	Respostas rápidas
gemini-2.0-flash	1M tokens	JSON, Grounding	Tarefas padrão
gemini-1.5-pro	2M tokens	JSON	Suporte legado

Início Rápido

Obtenha sua Chave de API do Gemini
- Visite o Google AI Studio
- Crie uma nova chave de API
- IMPORTANTE: Mantenha sua chave de API segura e nunca a envie para o controle de versão

Configure Seu Cliente MCP

Claude Desktop

Local do arquivo de configuração:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gemini": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:aliargun/mcp-server-gemini"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Adicione nas configurações MCP do Cursor:

{
  "gemini": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "github:aliargun/mcp-server-gemini"],
    "env": {
      "GEMINI_API_KEY": "your_api_key_here"
    }
  }
}

Windsurf

Configure nas configurações MCP do Windsurf seguindo a documentação deles.

Outros Clientes MCP

Use a configuração padrão MCP stdio:

{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "github:aliargun/mcp-server-gemini"],
  "env": {
    "GEMINI_API_KEY": "your_api_key_here"
  }
}

Reinicie Seu Cliente MCP

Como Usar

Após a configuração, você pode usar linguagem natural no seu cliente MCP para acessar os recursos do Gemini:

Comandos Básicos

"Use Gemini to explain quantum computing"
"Analyze this image with Gemini" 
"List all Gemini models"
"Get help on using Gemini"

Exemplos Avançados

"Use Gemini 2.5 Pro with temperature 0.3 to review this code"
"Use Gemini in JSON mode to extract key points with schema {title, summary, tags}"
"Use Gemini with grounding to research the latest in quantum computing"

📖 Veja o Guia de Uso completo para exemplos detalhados e recursos avançados.

Por que o Gemini MCP Server?

Acesse os Modelos Mais Recentes: Use o Gemini 2.5 com recursos de raciocínio - os modelos mais avançados do Google
Conjunto Completo de Recursos: Todos os recursos da API Gemini, incluindo modo JSON, grounding e instruções de sistema
Configuração Fácil: Instalação npx de uma linha, sem necessidade de configuração complexa
Pronto para Produção: Tratamento abrangente de erros, tipos TypeScript e documentação extensa
Desenvolvimento Ativo: Atualizações regulares com novos recursos do Gemini conforme são lançados

Documentação

Guia de Uso - Guia completo sobre como usar todas as ferramentas e recursos
Referência de Parâmetros - Documentação detalhada de todos os parâmetros
Referência Rápida - Folha de consulta rápida de comandos
Recursos Aprimorados - Lista detalhada dos recursos da v4.0.0
Guia de Configuração do Claude Desktop - Instruções detalhadas de configuração
Exemplos e Uso - Exemplos de uso e configuração avançada
Notas de Implementação - Detalhes técnicos de implementação
Guia de Desenvolvimento - Guia para desenvolvedores
Guia de Solução de Problemas - Problemas comuns e soluções

Desenvolvimento Local

# Clone repository
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env and add your GEMINI_API_KEY

# Start development server
npm run dev

Contribuindo

Contribuições são bem-vindas! Consulte nosso Guia de Contribuição.

Problemas Comuns

Problemas de Conexão
- Certifique-se de que seu cliente MCP foi reiniciado corretamente
- Verifique os logs do cliente (por exemplo, ~/Library/Logs/Claude/mcp-server-gemini.log para Claude Desktop no Mac)
- Verifique a conexão com a internet
- Consulte o Guia de Solução de Problemas
Problemas com a Chave de API
- Verifique se a chave de API está correta
- Verifique se a chave de API tem as permissões adequadas
- Certifique-se de que a chave está definida na variável de ambiente
- Consulte o Guia de Configuração

Segurança

As chaves de API são tratadas apenas por meio de variáveis de ambiente
Nunca envie chaves de API para o controle de versão
O diretório .claude/ é excluído do git
Nenhum dado sensível é registrado ou armazenado
Atualizações regulares de segurança
Se sua chave de API for exposta, regenere-a imediatamente no Google Cloud Console

Licença

MIT