MCP CLI Gemini

MCP server that wraps Gemini CLI for use with other AI tools via the Model Context Protocol.

Features

Single unified gemini tool that supports:

• One-shot queries to Gemini CLI
• Interactive mode session commands
• Extension management

Prerequisites

• Gemini CLI installed and configured
• Node.js 18+

Installation

npm install
npm run build

Usage

Add to Claude Desktop

Edit your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the server:

{
  "mcpServers": {
    "gemini-cli": {
      "command": "node",
      "args": ["D:\\WORKSPACE\\tools-node\\mcp-cli-gemini\\dist\\index.js"]
    }
  }
}

Add to Other MCP Clients

Use stdio transport with:

node dist/index.js

Available Tools

gemini

Unified tool for all Gemini CLI operations.

Parameters:

• query (required): Query to send to Gemini CLI
• model (optional): Model to use (e.g., "gemini-pro", "gemini-1.5-flash")
• sandbox (optional): Run in sandbox mode for code execution
• yolo (optional): Auto-approve all actions
• interactive (optional): Run in interactive mode (returns command for manual execution)
• extensions (optional): Extension command: "list" or "info:extensionName"

Examples:

Basic query:

{
  "query": "Explain how async/await works in JavaScript",
  "model": "gemini-1.5-flash"
}

Interactive mode:

{
  "query": "Let's discuss design patterns",
  "interactive": true
}

List extensions:

{
  "query": "",
  "extensions": "list"
}

Get extension info:

{
  "query": "",
  "extensions": "info:extension-name"
}

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Watch mode
npm run watch

# Lint
npm run lint

# Lint and fix
npm run lint:fix

License

MIT