Skip to main content
Glama

Weather-MCP-Server

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.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

这是一个模型上下文协议 (MCP) 服务器,使用国家气象局 (NWS) API 提供天气信息。

功能获取美国某个州的天气警报获取特定位置的天气预报(使用纬度和经度)

  1. 特征
    1. 要求
      1. 安装
        1. 配置
          1. 用法
            1. 独立运行服务器
            2. 与 Cline 一起使用
          2. 错误处理和日志记录
            1. 测试
              1. 单元测试
              2. 手动测试
            2. 贡献
              1. 执照

                Related MCP Servers

                • -
                  security
                  F
                  license
                  -
                  quality
                  This SSE-based MCP server allows users to connect and interact with National Weather Service APIs to retrieve weather alerts and forecasts.
                  Last updated -
                  296
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that provides tools to fetch weather alerts for US states and forecasts based on latitude/longitude coordinates using the US National Weather Service API.
                  Last updated -
                  2
                  56
                  MIT License
                  • Linux
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that provides weather information like forecasts and alerts for US locations using the National Weather Service API.
                  Last updated -
                  2
                • A
                  security
                  F
                  license
                  A
                  quality
                  An MCP server that provides weather information and alerts for US locations using the National Weather Service API, enabling retrieval of weather forecasts and active weather alerts.
                  Last updated -
                  2

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/JackKuo666/Weather-MCP-Server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server