/gemini-cli-mcp

Primary LanguageTypeScriptISC LicenseISC

MCP Gemini

A Model Context Protocol (MCP) wrapper for Google Gemini CLI that enables AI IDEs and agents to interact with Gemini through a standardized JSON-RPC interface. This MCP tool borrows the idea from https://www.reddit.com/r/ChatGPTCoding/comments/1lm3fxq/gemini_cli_is_awesome_but_only_when_you_make/.

Overview

MCP Gemini provides a bridge between AI development tools and the Google Gemini CLI, allowing seamless integration of Gemini's large context window capabilities into various AI workflows.

Prerequisites

  • Node.js 16.0.0 or higher
  • Google Gemini CLI installed and available

How to use

mcp configuration

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
        "args": ["-y", "mcp-gemini"],
        "env": {
          "GEMINI_CLI_PATH": <YOUR_GEMINI_CLI_PATH>, //Optional, but it's better to set it.
          "GEMINI_API_KEY": <YOUR_GEMINI_API_KEY> // Optional if you use oauth
      }
    }
  }
}

Available tools

  • analyze_files - Analyze multiple files with Gemini CLI
  • analyze_directory - Analyze directories with Gemini CLI
  • verify_feature - Verify feature implementation in codebase
  • raw_prompt - Execute raw prompts without file context
  • get_config / set_config - Configuration management, supporting config:
    • geminiPath
    • defaultTimeout
    • defaultMaxOutputKB
    • defaultFlags

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Ensure all tests pass
  6. Submit a pull request

License

ISC License - see LICENSE file for details.

Support

For issues and questions: