Google Maps Reviews Scraper

MCP Server generated by mcp.ag2.ai

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "qingyun-wu-google-maps-reviews-scraper": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "A JSON string containing the configuration",
        "SECURITY": "Environment variables for security parameters (e.g., API keys)",
        "CONFIG_PATH": "Path to a JSON configuration file (e.g., mcp_server/mcp_config.json)"
      }
    }
  }
}

You run an MCP server to host and coordinate multi-agent conversations through a stable, programmable transport. This server is written in Python and is designed to start in stdio mode, allowing you to connect using an MCP client via a local process.

How to use

Start the MCP server in stdio mode and connect your MCP client to the local process. You configure startup behavior with environment variables or a JSON config to control how the server loads its settings.

How to install

Prerequisites: you need Python 3.9 or newer, and you should have pip and a runtime like uv available.

# Prerequisites
# Ensure Python 3.9+ is installed
python --version

# Install with dependencies (dev dependencies included)
pip install -e ".[dev]"

# Alternative using uv (if you prefer)
uv pip install --editable ".[dev]"

Clone the project, install dependencies, and prepare to run the server.

git clone <repository-url>
cd mcp_server

Run linting, static analysis, and tests as part of your development workflow.

# Linting
ruff check

# Formatting
ruff format

# Static analysis
./scripts/static-analysis.sh

# Tests with coverage
./scripts/test.sh
./scripts/test-cov.sh

Configuration and run how-to

The MCP server starts in stdio mode using a Python command. You can pass runtime configuration via environment variables.

# Start in stdio mode (example)
python mcp_server/main.py stdio

Available startup environment variables include paths to a JSON configuration and a raw JSON string, plus security-related variables. Use these to control how the server initializes.

Configuration details

Environment variables you can set for startup and security are:

CONFIG_PATH: Path to a JSON configuration file (for example, mcp_server/mcp_config.json).
CONFIG: A JSON string containing the configuration.
SECURITY: Environment variables for security parameters (for example, an API key). These are read by the server at startup.

When you start the server, you’ll see it ready to accept MCP client connections via the stdio channel. The server will handle message orchestration according to the configured MCP routes and agents.

Available tools

lint

Lint and format code using ruff to ensure consistent style and catch errors.

static-analysis

Run static analysis (mypy, bandit, semgrep) to identify type issues and security concerns.

tests

Execute tests with pytest and generate coverage reports to verify correctness.

server-run

Start the MCP server in a specified transport mode (e.g., stdio) and interact with clients.

Built by

VeilStrat

AI signals for GTM teams