Gemini CLI Configuration

You can configure the Gemini CLI to use this MCP server, allowing you to interact with Gerrit directly from your terminal. The server can be run in two modes: HTTP or STDIO.

HTTP Mode

In HTTP mode, the server runs as a persistent background process. This is recommended for frequent use.

  1. Start the Server: From the gerrit-mcp-server project directory, run:

    ./server.sh start
    
  2. Configure Gemini CLI: Add the following to your $HOME/.gemini/settings.json file. This tells the CLI to connect to the running HTTP server.

    {
      "mcpServers": {
        "gerrit": {
          "httpUrl": "http://localhost:6322/mcp",
          "timeout": 15000
        }
      }
    }
    

STDIO Mode

In STDIO mode, the Gemini CLI starts the MCP server on-demand for each request. This is useful if you don't want a server running in the background.

Configure Gemini CLI: Add the following to your $HOME/.gemini/settings.json file. Make sure to replace <path_to_project> with the absolute path to your gerrit-mcp-server project directory.

{
  "mcpServers": {
    "gerrit": {
      "command": "<path_to_project>/.venv/bin/python",
      "args": [
        "<path_to_project>/gerrit_mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "PYTHONPATH": "<path_to_project>/"
      }
    }
  }
}

Now, when you run gemini, you can use the @gerrit tool directly.