Visual Crossing

Basic MCP server for Visual Crossing historical weather data

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 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": {
    "peterjohnbeck-visual_crossing_mcp": {
      "command": "C:\\\\Programs\\\\Python\\\\Python311\\\\python.exe",
      "args": [
        "C:\\\\Path\\\\To\\\\Server\\\\Python\\\\File\\\\visual_crossing_mcp.py"
      ],
      "env": {
        "API_KEY": "YOUR_VISUAL_CROSSING_API_KEY"
      }
    }
  }
}

This MCP server lets you fetch historical weather data from Visual Crossing for a specific location and date or date range. It exposes a set of weather measurements such as temperature, precipitation, wind, cloud cover, and more, so you can integrate historical weather insights into your workflows or applications.

How to use

You use this MCP server by running it locally and connecting your MCP client to start requesting historical weather data for a location and date window. You specify the location and date range, and you receive detailed weather fields such as temperature, max/min temperature, precipitation, solar radiation, cloud cover, snow depth, weather type and conditions, heat index, and wind chill.

How to install

Prerequisites you need before installation: Python and pip, and access to the Visual Crossing API with a valid API key.

pip install -r requirements.txt

Create or modify a configuration file to store your API key. Place the key in a file named ".env" at the project root with the following content.

API_KEY=YOUR_VISUAL_CROSSING_API_KEY

optional: configure the Claude client integration by providing the Python interpreter path and the path to the MCP script. This enables Claude to start the server directly from its internal client.

"weather": {
  "command": "C:\\Programs\\Python\\Python311\\python.exe",
  "args": ["C:\\Path\\To\\Server\\Python\\File\\visual_crossing_mcp.py"]
}

Additional sections

Notes about usage and configuration

The server reads an API key from the ".env" file as API_KEY. Keep this value secure and do not expose it in public configurations.
The MCP script to run is the Visual Crossing MCP Python file referenced in the configuration. Ensure you provide the correct path to that script in your environment.
The server exposes a set of data fields you can request for a given location and date range, including temperature, precipitation, wind-related metrics, solar radiation, cloud cover, and various weather condition indicators.