Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • HeFeng Weather MCP Server
  • Weekly Weather
  • Perplexity AI MCP Server
  • MCP Server for ArangoDB
  • AGE-MCP-Server
Back to MCP Servers
Weather-MCP-Server

Weather-MCP-Server

Public
JackKuo666/Weather-MCP-Server

Provides weather alerts and forecasts for US locations using the National Weather Service API through Model Context Protocol tools, enabling seamless integration and real-time weather data retrieval.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with Weather-MCP-Server

MCP Server

Unlock the full potential of Weather-MCP-Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Weather MCP Server

This is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API.

Features

  • Get weather alerts for a US state
  • Get weather forecast for a specific location (using latitude and longitude)

Requirements

  • Python 3.10+
  • FastMCP
  • httpx

Installation

  1. Clone this repository
  2. Set up a virtual environment:
    python -m venv .venv
    source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`
    
  3. Install the required packages using uv:
    uv add "mcp[cli]" httpx
    

Configuration

The server uses a configuration file config.py with the following settings:

  • NWS_API_BASE: The base URL for the National Weather Service API
  • USER_AGENT: The User-Agent string used when making requests to the NWS API
  • LOG_LEVEL: The logging level (e.g., "INFO", "DEBUG")
  • LOG_FORMAT: The format string for log messages
  • REQUEST_TIMEOUT: The timeout for API requests in seconds

You can modify these settings in the config.py file to customize the server behavior.

Usage

Running the server standalone

To run the server standalone:

  1. Activate the virtual environment if not already activated:
    source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`
    
  2. Run the server:
    python weather.py
    

Using with Cline

The Weather MCP Server has been added to the Cline configuration. To use it within Cline:

  1. Ensure that Cline is properly set up and running.

  2. The Weather MCP Server will be available as a tool named "weather".

  3. You can use the following tools within Cline:

    a. get_alerts(state: str): Get weather alerts for a US state (use two-letter state code, e.g., "CA" for California) b. get_forecast(latitude: float, longitude: float): Get weather forecast for a specific location

Example usage in Cline:

# Get alerts for California
result = await mcp.call_tool("weather.get_alerts", state="CA")
print(result)

# Get forecast for San Francisco (approximate coordinates)
result = await mcp.call_tool("weather.get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

Note: The exact syntax for calling MCP tools may vary depending on your Cline setup. Refer to Cline documentation for the most up-to-date usage instructions.

Error Handling and Logging

The server includes improved error handling for API requests and logging. If an error occurs during a request, the server will log the error and return an appropriate error message. Logs are printed to the console with the configured log level and format.

Testing

Unit Tests

To run the unit tests:

python -m unittest test_weather.py

These tests cover the basic functionality of the get_alerts and get_forecast tools.

Manual Testing

To manually test the server, you can use the MCP client to call the provided tools. Here are some example commands:

# Get alerts for California result = await mcp.call_tool("get_alerts", state="CA") print(result) # Get forecast for San Francisco (approximate coordinates) result = await mcp.call_tool("get_forecast", latitude=37.7749, longitude=-122.4194) print(result)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • HeFeng Weather MCP Server
    HeFeng Weather MCP Server

    Provides real-time and extended weather forecasts for locations in China using Model Context Protoco...

    1 tools
    Added May 30, 2025
  • Weekly Weather
    Weekly Weather

    Provides 8-day global weather forecasts and current conditions with detailed hourly and daily data, ...

    Added May 30, 2025
  • Perplexity AI MCP Server
    Perplexity AI MCP Server

    Provides seamless integration with Perplexity AI via Model Context Protocol, enabling chat, search, ...

    5 tools
    Added May 30, 2025
  • MCP Server for ArangoDB
    MCP Server for ArangoDB

    Model Context Protocol server enabling seamless interaction with ArangoDB through core database oper...

    7 tools
    Added May 30, 2025
  • AGE-MCP-Server
    AGE-MCP-Server

    Enables integration of Apache AGE graph database capabilities with Azure Database for PostgreSQL thr...

    Added May 30, 2025