mcp-learning

ramo772/mcp-learning

3.2

If you are the rightful owner of mcp-learning and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This project is a learning repository focused on building a Model Context Protocol (MCP) server to provide weather information using the National Weather Service API.

Learning MCP: Weather Server

A learning project to explore and understand the Model Context Protocol (MCP) by building a practical weather information server using the National Weather Service API.

About This Project

This is a learning repository focused on understanding how to build MCP servers. The project implements a simple weather information service to demonstrate:

  • How to set up an MCP server
  • How to define and register tools
  • How to handle API requests within MCP
  • How to work with the MCP SDK and protocols
  • Integration with external APIs (National Weather Service)

What is MCP?

The Model Context Protocol (MCP) is a standardized way to provide context and tools to AI assistants. This project serves as a practical example of building an MCP server from scratch.

Features Implemented

  • 🚨 Weather Alerts Tool: Fetches active weather alerts by state
  • 🌡️ Weather Forecast Tool: Retrieves forecasts for GPS coordinates
  • 📡 API Integration: Demonstrates external API calls within MCP
  • Schema Validation: Uses Zod for input validation

Getting Started

npm install
npm run build