Weather Service MCP Server

A Spring Boot-based weather service providing weather forecasts and alerts via MCP integration.

GitHub

MCP-Server

Weather Service MCP Server

A Spring Boot-based weather service that provides weather forecasts and alerts through Model Context Protocol (MCP) integration. This service currently uses the U.S. National Weather Service API to fetch weather data.

Features

  • Get detailed weather forecasts by latitude/longitude
  • Retrieve weather alerts for US states
  • MCP server integration for Cursor IDE
  • Temperature, wind, and detailed forecast information
  • Error handling for invalid locations

Prerequisites

  • Java 21 or higher
  • Maven 3.6 or higher
  • Cursor IDE (for MCP integration)

Setup Instructions

  1. Clone the Repository

    git clone https://github.com/Ahmed-Naseer-01/MCP-Server.git
cd Weather-server

  2. Set Java 21

    export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home

  3. Build the Project

    ./mvnw clean package -DskipTests

  4. Configure MCP Server Go to Cursor setting->MCP Tools->mcp.json(create this file) Create or update ~/.cursor/mcp.json:

    {
  "mcpServers": {
    "spring-ai-mcp-weather": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "/path/to/your/Weather-server/target/Weather-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

    Replace /path/to/your with your actual project path.

Limitations

  • Currently only supports US locations through the National Weather Service API
  • Alerts are only available for US states
  • All temperatures are in Fahrenheit

Serveurs connexes