mcp-server-sample

mcp-server-sample

43
communicationdeveloper_toolsweather

This project is an example of a Model Context Protocol (MCP) server created for educational purposes. It integrates weather-related tools using the National Weather Service API to fetch alerts and forecasts. The architecture applies domain-driven design principles.

Example MCP Server

This project was created for educational purposes on the Código Fonte TV channel. It demonstrates how to build an MCP server with integration to external APIs and data validation.

Features

  • Obtain active weather alerts for a state.
  • Retrieve weather forecasts for geographical coordinates.
  • Input validation using Zod.
  • Integration with the NWS API using fetch.
  • Communication via stdio using the MCP protocol.

Architecture

  • Domain: Defines data structures.
  • Infrastructure: Implements external services like NWSApiService.
  • Application: Contains business logic in WeatherService.
  • Interface: Includes controllers that register tools on the MCP server.

Installation

Clone the repository and install dependencies: npm install.

Usage

Run the server with node build/main.js or use the binary weather. The server will listen on stdio for MCP requests.