Gemini

Integra con los modelos de IA Gemini de Google para diversas tareas.

GitHub
1

Documentación

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
  1. Instale las dependencias:
npm install
  1. Compile el proyecto:
npm run build
  1. 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