MCP Weather Demo - README

Overview

This demo implements a minimal MCP-style JSON-RPC endpoint exposing a getWeather(city) capability. The server calls OpenWeatherMap (OWM) API and returns a simplified result.

Setup

1. Install Node.js (>=16).

2. Copy this folder to your machine.

3. Create a free OpenWeatherMap API key: https://openweathermap.org/api

4. Set environment variable:

   • Unix/macOS: export OWM_KEY=your_key_here

   • Windows (PowerShell): $env:OWM_KEY='your_key_here'

Install & Run

npm install

development (no build)

npx ts-node src/server.ts

or build & run

npm run build npm start

Test

Use the provided client: npx ts-node src/client.ts

Or use curl: curl -X POST http://localhost:3000/json-rpc -H 'Content-Type: application/json' -d '{ "jsonrpc":"2.0", "method":"getWeather", "params": {"city":"London"}, "id":1 }'

Notes

• This is a minimal example for demo/educational purposes.

• Add caching, rate-limiting, better error handling, and authentication for production.