gemini-cli-mcp

# `gemini-cli-mcp` Python Server This directory contains the Python implementation of the `gemini-cli-mcp` server. It uses FastAPI to expose `gemini-cli` functionalities as MCP-compliant tools. ## 1. Features This server exposes the following `gemini-cli` commands as MCP Tools: * `gemini_ask`: Ask a question to the Gemini model. * `gemini_yolo`: Run a complex prompt with Gemini Agent in auto-execution (`--yolo`) mode. * `gemini_git_commit`: Generate a conventional commit message from staged changes and perform a `git commit`. * `gemini_git_pr`: Automatically commit, push, and create a Pull Request. * `gemini_git_diff`: Summarize code changes using Gemini AI. ## 2. Technology Stack | Category | Technology | | :--------------- | :------------------- | | **Language** | Python 3.12+ | | **Web Framework**| FastAPI | | **Process Exec** | `asyncio.subprocess` | | **CLI Framework**| Typer (via `mcp-cli`)| | **Packaging** | Poetry / `pyproject.toml` | ## 3. Setup ### Prerequisites * Python 3.12 or higher. * `gemini-cli` installed globally and accessible in your system's PATH. * `git` installed and configured. ### Installation 1. Navigate to the `server_py` directory: ```bash cd server_py ``` 2. Install dependencies using `uv` (recommended) or `pip`: ```bash uv pip install -r requirements.txt # or pip install -r requirements.txt ``` ### Environment Variables The server uses environment variables for configuration. You can set these in a `.env` file in the project root (`/path/to/project_root/.env`) or directly in your environment. * `GEMINI_MODEL`: Specifies the Gemini model to use (e.g., `gemini-2.5-flash`). * `GEMINI_ALL_FILES`: Set to `true` to include all files in context (`--all-files`). * `GEMINI_SANDBOX`: Set to `true` to enable sandbox mode (`--sandbox`). * `GEMINI_API_KEY`: Your Gemini API key (required for Docker/server environments). * `PROJECT_R…