Gemini

Gemini MCP Server

Servidor MCP (Model Context Protocol) para la integración con Gemini AI. Proporciona herramientas para realizar consultas a Gemini a través de Claude Code.

Características

• gemini_query - consultas básicas a Gemini AI
• gemini_unsafe - consultas con confirmación automática de operaciones no seguras
• Funciona a través del transporte stdio
• Integración con Claude Code a través del protocolo MCP

Instalación

Requisitos

• Node.js
• gemini CLI instalado
• Clave API de Gemini

Inicio rápido

1. Clone el repositorio:

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

2. Instale las dependencias:

npm install

3. Compile el proyecto:

npm run build

4. Agregue el servidor MCP a Claude Code:

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

Configuración

Variables de entorno

• GEMINI_API_KEY - clave API para Gemini AI (obligatorio)

Método alternativo de conexión

Agregue a la configuración de 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

Después de conectarse a Claude Code, están disponibles dos herramientas:

gemini_query

Herramienta básica para enviar consultas a Gemini AI.

Parámetros:

• prompt (string, required) - texto de la consulta

gemini_unsafe

Herramienta para consultas con confirmación automática de operaciones no seguras.

Parámetros:

• prompt (string, required) - texto de la consulta
• auto_confirm (boolean, optional) - confirmar operaciones automáticamente

Desarrollo

Comandos

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

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

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

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

Estructura del proyecto

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

Arquitectura

1. MCP Server - utiliza @modelcontextprotocol/sdk
2. Transport - StdioServerTransport para la comunicación con Claude Code
3. Tools - herramientas para trabajar con Gemini CLI
4. Command Execution - procesos spawn para invocar gemini CLI

Licencia

MIT

Autor

Creado con Claude Code