mcpproject

Provides real-time US state weather alerts via NWS API with development tooling and inspection.

python

1

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shubhechhadey-mcpproject": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "dev",
        "server/weather.py"
      ]
    }
  }
}

This MCP server provides real-time weather alerts for US states by using the National Weather Service API. It runs on modern async Python workflows and exposes development tooling to test, inspect, and install the weather tool within an MCP environment.

How to use

You develop and test the weather MCP server locally, then call its tools from an MCP client. The main tool you’ll use is get_alerts, which returns current active weather alerts for a two-letter state code (for example, CA or NY). You can also test the server with a simple echo endpoint to verify that your MCP runtime is wired correctly.

How to install

Prerequisites you need before installing: Python 3.12+ and the MCP runtime tool uv.

Install the MCP runtime and dependencies.
Install the weather MCP tool for use in development.

Additional steps and usage notes

Run the development server for the weather MCP tool to begin testing. This starts a local MCP development server and opens MCP Inspector in your browser, allowing you to explore and test MCP tools and resources interactively.

Install and run commands shown below use the MCP runtime uv.

To run the basic entry point for the project, you can print a startup message from the main script.

Usage examples

With the development server running, call the get_alerts tool using a state code. Example: CA.

Example from a CLI MCP client: mcp call get_alerts --state=CA

Available tools

get_alerts

Fetches and formats active weather alerts for a US state.

echo

Echo endpoint for testing MCP server behavior.

inspector

MCP Inspector visual tool to inspect and test MCP tools and resources.