Gemini

Servidor MCP Gemini

Servidor MCP (Model Context Protocol) para integração com o Gemini AI. Fornece ferramentas para executar consultas ao Gemini através do Claude Code.

Recursos

• gemini_query - consultas básicas ao Gemini AI
• gemini_unsafe - consultas com confirmação automática de operações não seguras
• Funciona via transporte stdio
• Integração com o Claude Code através do protocolo MCP

Instalação

Requisitos

• Node.js
• gemini CLI instalado
• Chave de API do Gemini

Início rápido

1. Clone o repositório:

git clone https://github.com/Stesm/gemini-mcp.git
cd gemini-mcp

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

4. Adicione o servidor MCP ao Claude Code:

claude mcp add gemini node /path/to/gemini-mcp/dist/index.js -e GEMINI_API_KEY=your_api_key

Configuração

Variáveis de ambiente

• GEMINI_API_KEY - chave de API para o Gemini AI (obrigatório)

Método alternativo de conexão

Adicione à configuração do Claude Code (~/.config/claude-code/claude_desktop_config.json):

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/path/to/gemini-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key"
      }
    }
  }
}

Uso

Após a conexão com o Claude Code, duas ferramentas estão disponíveis:

gemini_query

Ferramenta básica para enviar consultas ao Gemini AI.

Parâmetros:

• prompt (string, obrigatório) - texto da consulta

gemini_unsafe

Ferramenta para consultas com confirmação automática de operações não seguras.

Parâmetros:

• prompt (string, obrigatório) - texto da consulta
• auto_confirm (boolean, opcional) - confirmar operações automaticamente

Desenvolvimento

Comandos

# Установка зависимостей
npm install

# Сборка проекта
npm run build

# Запуск сервера
npm start

# Разработка (сборка + запуск)
npm run dev

Estrutura do projeto

├── src/
│   └── index.ts          # MCP сервер с инструментами Gemini
├── dist/                 # Скомпилированный JavaScript
├── package.json          # Конфигурация и зависимости
├── tsconfig.json         # Конфигурация TypeScript
└── CLAUDE.md            # Документация для Claude Code

Arquitetura

1. Servidor MCP - usa @modelcontextprotocol/sdk
2. Transporte - StdioServerTransport para comunicação com o Claude Code
3. Ferramentas - ferramentas para trabalhar com o Gemini CLI
4. Execução de comandos - processos spawn para chamar o gemini CLI

Licença

MIT

Autor

Criado com Claude Code