Weather

You can run a minimal MCP-style service that exposes a getWeather(city) capability. The server talks to a weather API and returns a concise result that you can query from MCP clients to get current weather data. This guide walks you through using, installing, and understanding this weather MCP server in practical steps.

How to use

You interact with the weather MCP server by sending a request to the exposed endpoint to fetch weather data for a city. Use your MCP client to call the getWeather capability with a city name, and you will receive a structured weather result that you can display in your app or workflow.

How to install

Prerequisites: ensure you have Node.js installed (version 16 or newer). You also need access to a weather API key to fetch real-time data.

Step-by-step commands you should run on your machine:

# 1) Ensure Node.js is installed (version 16+)
node -v

# 2) Copy this folder to your machine (or clone it into a working directory)
# Copy the folder contents into a local path of your choosing

# 3) Create a free OpenWeatherMap API key at https://openweathermap.org/api
# 4) Set the environment variable for the API key (adjust for your shell)
# Unix/macOS:
export OWM_KEY=your_key_here
# Windows (PowerShell):
$env:OWM_KEY='your_key_here'

# 5) Install dependencies
npm install

# 6) Run in development mode (no build required)
npx ts-node src/server.ts

# 7) Or build and run in production-like mode
npm run build
npm start

Additional setup notes

The server exposes a JSON-RPC endpoint that you can call to request weather data for a given city. This is a focused demo designed for educational purposes, so you may want to add production-ready features such as caching, rate limiting, improved error handling, and authentication if you plan to deploy publicly.

Available tools

getWeather

Fetches current weather data for a specified city by invoking the getWeather capability on the MCP server.