MCP US Weather Client/Server

What is Hands-on-MCP?

Hands-on-MCP is a project that implements a Model Context Protocol (MCP) server to provide weather alert information for US states, utilizing the National Weather Service (NWS) API. It includes a client application that demonstrates interaction with the MCP server using the mcp_use library.

How to use Hands-on-MCP?

To use Hands-on-MCP, clone the repository, install the necessary dependencies, set up your environment variables, and run the server and client applications. You can interact with the client by typing queries related to weather alerts.

Key features of Hands-on-MCP?

• Fetches and formats active weather alerts for specified US states.
• Demonstrates MCP server construction using the fastmcp library.
• Provides a client application that integrates conversation memory.
• Showcases integration with Langchain for LLM interactions.

Use cases of Hands-on-MCP?

1. Fetching real-time weather alerts for different states.
2. Demonstrating the use of MCP in client-server architecture.
3. Integrating weather data into applications using the NWS API.

FAQ from Hands-on-MCP?

• What programming language is used?

  The project is implemented in Python.

• Do I need an API key?

  Yes, a Groq API key is required and should be added to the .env file.

• How do I run the server and client?

  Use the command uv run mcp dev server/weather.py to start the server and uv run server/client.py to start the client.