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
- Install Node.js (>=16).
- Copy this folder to your machine.
- Create a free OpenWeatherMap API key: https://openweathermap.org/api
- 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.