US Weather Alerts & Forecasts
adarshemLABSCO SUMMARY
US only, and it says so.
The limitations section is the most useful part of the README: this reads the National Weather Service, so locations outside the United States are out of scope and the temperatures are Fahrenheit. Inside that boundary it needs no key at all, which makes it a short path to real forecast data in an editor.
What it is
A Spring Boot weather service exposed over MCP. It reads the U.S. National Weather Service API and answers two kinds of question: a detailed forecast for a latitude and longitude, and the active alerts for a US state.
What you get
- A detailed forecast for a given latitude and longitude, including temperature, wind and the narrative forecast text
- Active weather alerts for a US state
- Errors handled for invalid locations rather than returned as empty results
- A stdio server started by the client, with
-Dspring.ai.mcp.server.stdio=trueon the java command
Requirements
Java 21 or higher and Maven 3.6 or higher. Build with ./mvnw clean package -DskipTests, then register it in ~/.cursor/mcp.json as a java -jar command against the built Weather-server-0.0.1-SNAPSHOT.jar. No API key — the National Weather Service API is public. Coverage is US-only by construction: alerts are per US state, and temperatures come back in Fahrenheit.
Setup effort
Build from source — git clone https://github.com/Ahmed-Naseer-01/MCP-Server.git
USE CASES
01
Getting a forecast for a specific spot
Pass coordinates rather than a place name and read the detailed forecast back.
02
Checking active alerts before travelling
Ask for the state's alerts in the conversation where the trip is being planned.
03
Adding weather to an editor without a key
Point Cursor at the built jar and query a public API with no credentials to manage.
BEFORE YOU INSTALL
What to know first
Requires
- Java 21 or later
- Maven 3.6 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/Ahmed-Naseer-01/MCP-Server.git
cd MCP-Server/Weather-server
./mvnw clean package -DskipTestsMCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"spring-ai-mcp-weather": {
"command": "java",
"args": [
"-Dspring.ai.mcp.server.stdio=true",
"-jar",
"<YOUR_PATH_TO_WEATHER_SERVER>/target/Weather-server-0.0.1-SNAPSHOT.jar"
]
}
}
}
