README.md•1.06 kB
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.