{
  "markdown": "# 🐍 Gerrit MCP Server\n\nAn MCP (Model Context Protocol) server for interacting with the Gerrit code\nreview system. This server allows a language model like Gemini to query changes,\nretrieve details, and manage reviews by executing `curl` commands against the\nGerrit REST API.\n\nThis server can be run as a persistent **HTTP server** or on-demand via\n**STDIO**.\n\n## 📚 Documentation\n\nFor detailed information, please see the documents in the `docs/` directory:\n\n- **[Configuration](docs/configuration.md)**: A detailed guide to the\n  `gerrit_config.json` file and all authentication methods.\n- **[Testing Guide](docs/testing.md)**: Instructions on how to run the unit,\n  integration, and E2E tests.\n- **[Gemini CLI Setup](docs/gemini-cli.md)**: How to configure the Gemini CLI to\n  use this server.\n- **[Claude Code Setup](docs/claude-code.md)**: How to use this server as a\n  Claude Code plugin.\n- **[Best Practices](docs/best_practices.md)**: Tips for using the server\n  effectively.\n- **[Contributing](docs/contributing.md)**: Guidelines for contributing to the\n  project.\n- **[Available Tools](docs/available_tools.md)**: A list of all available tools\n  and their descriptions.\n- **[Extensions](docs/extensions.md)**: How to register additional MCP tools\n  without modifying the core server.\n- **[Example Use Cases](docs/use_cases.md)**: Scenarios demonstrating how to use\n  the server.\n\n## 🚀 Getting Started\n\n### 1. Prerequisites\n\nBefore you begin, ensure you have the following tools installed and available in\nyour system's `PATH`.\n\n- **Python 3.12+**: Required by the server.\n- **[uv](https://docs.astral.sh/uv/getting-started/installation/)**: Used for\n  dependency management and running the server. Optional — the build script will\n  install it via `pip` if absent.\n- **curl**: The standard command-line tool for transferring data with URLs.\n\n### 2. Build the Environment\n\nRun the build script from the root of the `gerrit-mcp-server` project directory.\nThis will create a virtual environment in `.venv` via `uv sync` and install all\ndependencies.\n\n```bash\n./build-gerrit.sh\n```\n\n### 3. Configure the Server\n\nYou will need to create a `gerrit_config.json` file inside the\n`gerrit_mcp_server` directory. Copy the provided sample file\n`gerrit_mcp_server/gerrit_config.sample.json` and customize it for your\nenvironment. See the **[Configuration Guide](docs/configuration.md)** for\ndetails on all available options.\n\n```bash\ncp gerrit_mcp_server/gerrit_config.sample.json gerrit_mcp_server/gerrit_config.json\n```\n\nAlternatively, if your harness supports skills (tested with Claude Code), the\n`/gerrit:setup` skill can create or repair this file for you interactively. See\n**[Interactive Setup](docs/configuration.md#interactive-setup-gerritsetup)**.\n\n### 4. Run the Server (HTTP Mode)\n\nTo run the server as a persistent background process, use the `server.sh`\nscript:\n\n- **Start the server:**\n  ```bash\n  ./server.sh start\n  ```\n- **Check the status:**\n  ```bash\n  ./server.sh status\n  ```\n- **Stop the server:**\n  ```bash\n  ./server.sh stop\n  ```\n\nFor on-demand STDIO mode, please see the\n**[Gemini CLI Setup Guide](docs/gemini-cli.md)** or, to use this server as a\nClaude Code plugin, the **[Claude Code Setup Guide](docs/claude-code.md)**.\n\n### Security\n\nThis is not an officially supported Google product. This project is not eligible\nfor the\n[Google Open Source Software Vulnerability Rewards Program](https://bughunters.google.com/open-source-security).\n",
  "bytes": 3467,
  "sha": "b4227fc413dabb642f6474fe7ac68161d7b615ebf3d94eca22653feeaf0a6447",
  "repo_slug": "gerritcodereview/gerrit-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gerritcodereview_gerrit_mcp_server_a63e185b/readme"
}