WeatherXM PRO MCP Server
An MCP server implementation exposing the WeatherXM PRO APIs as MCP tools, allowing clients to access weather station data, observations, and forecasts through the MCP protocol.
Features
- Get stations near a location (latitude, longitude, radius)
- Get stations within a bounding box (min/max latitude and longitude)
- Get all available stations
- Get the latest observation for a specific station
- Get historical observations for a station on a specific date
- Search for H3 cells by region name
- Get stations in a specific H3 cell
- Get weather forecast (daily or hourly) for a specific H3 cell
- Get hyperlocal forecast for a station and variable
- Get forecast performance (FACT) for a station and variable
- Get forecast ranking (FACT) for a station
Prerequisites
- Node.js and npm installed
- A valid WeatherXM PRO API key
Configuration
Clone the repository to your local machine.
git clone https://github.com/WeatherXM/weatherxm-pro-mcp.git
Installation
After cloning the repository, you need to install the dependencies and build the project before running the MCP server.
npm install
npm run build
Server Configuration for MCP Clients
This is the common configuration for MCP clients such as Claude Desktop, Cursor, Windsurf Editor, VSCode and plugins such as RooCode and Cline.
{
"mcpServers": {
"weatherxm-pro": {
"command": "npx",
"args": [
"-y",
"path to mcp"
],
"env": {
"WEATHERXMPRO_API_KEY": "your-api-key"
}
}
}
}
Replace "path to mcp" with the actual path to the MCP server or package name, and "your-api-key" with your WeatherXM PRO API key.
Note: If you have other MCP servers in use in the client, you can add it to the existing
mcpServersobject.
Claude Desktop
Follow the steps below to use the WeatherXM PRO MCP server with Claude Desktop MCP client:
-
Edit the MCP settings file located at:
~/Library/Application Support/Claude/claude_desktop_config.json -
Add the WeatherXM PRO MCP server configuration under the
mcpServersobject. -
Restart Claude Desktop to apply the changes.
-
You can now use the server in Claude Desktop to run queries on the WeatherXM PRO MCP server.
Cursor
Follow the steps below to use the WeatherXM PRO MCP server with Cursor:
- Install Cursor on your machine.
- In Cursor, go to Cursor > Cursor Settings > MCP > Add a new global MCP server.
- Specify the same configuration as in the Server Configuration for MCP Clients section.
- Save the configuration.
- You will see weatherxm-pro as an added server in MCP servers list.
- You can now use the WeatherXM PRO MCP server in Cursor to run queries.
Windsurf Editor
Follow the steps below to use the WeatherXM PRO MCP server with Windsurf Editor:
- Install Windsurf Editor on your machine.
- Navigate to Command Palette > Windsurf MCP Configuration Panel or Windsurf - Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers.
- Click on Add Server and then Add custom server.
- Add the WeatherXM PRO MCP Server configuration from the Server Configuration for MCP Clients section.
- Save the configuration.
- You will see weatherxm-pro as an added server in MCP Servers list.
- You can now use the WeatherXM PRO MCP server in Windsurf Editor to run queries.
Docker Image
The MCP server can be built and run as a Docker container.
Build
docker build -t weatherxm-pro-mcp .
Run
docker run -d -p 3000:3000 -e WEATHERXMPRO_API_KEY="your-api-key" -e PORT=3000 weatherxm-pro-mcp
Replace "your-api-key" with your actual WeatherXM PRO API key.
Troubleshooting Tips
- Ensure the path to your MCP server repository is correct in the configuration.
- Verify that your WeatherXM PRO API key is set correctly.
- Check that the MCP client configuration matches the server settings.
- Check the logs for any errors or warnings that may indicate issues with the MCP server.
License
MIT License