environment-mcp

MCP (Model Context Protocol) server that proxies Google Maps Platform Environment APIs: Air Quality, Pollen, and Weather. Uses stdio transport and a single API key from the environment.

Prerequisites

• Node.js 20+
• A Google Cloud project with billing enabled
• APIs enabled: Air Quality API, Pollen API, Weather API (APIs & Services → Library)
• An API key (APIs & Services → Credentials), with usage restricted appropriately for your setup

See the product setup guides for details: Air Quality, Pollen, Weather.

Install and run

npm install
npm run build

Set the key (do not commit it):

export GOOGLE_MAPS_API_KEY="your-key"

Alternatively use GOOGLE_ENVIRONMENT_API_KEY.

Start the server (stdio; typically launched by an MCP client, not used interactively):

npm start

For development with auto-reload:

npm run dev

Cursor MCP configuration

After npm run build, add a server entry (adjust the path to your clone):

{
  "mcpServers": {
    "google-environment": {
      "command": "node",
      "args": ["/absolute/path/to/environment-mcp/dist/index.js"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your-key-here"
      }
    }
  }
}

You can omit env if GOOGLE_MAPS_API_KEY is already set in your shell profile and Cursor inherits it (behavior depends on how Cursor is launched).

Tools

Tool	API
air_quality_current_conditions	POST .../v1/currentConditions:lookup
air_quality_forecast	POST .../v1/forecast:lookup
air_quality_history	POST .../v1/history:lookup
pollen_forecast	GET .../v1/forecast:lookup
weather_current_conditions	GET .../v1/currentConditions:lookup
weather_forecast_days	GET .../v1/forecast/days:lookup
weather_forecast_hours	GET .../v1/forecast/hours:lookup
weather_history_hours	GET .../v1/history/hours:lookup
weather_public_alerts	GET .../v1/publicAlerts:lookup

Air quality tools accept a JSON body with required location: { latitude, longitude } and optional fields per Google’s REST reference; other tools use typed arguments (coordinates, days, hours, unitsSystem, etc.).

Linting

Uses Ultracite (Biome preset):

npm run lint
npm run format

Security

• Never pass the API key in tool arguments; only use environment variables.
• Restrict the key in Google Cloud Console (HTTP referrers for browser use; IP or server-only patterns for backend).