README.md
Weather MCP Server
An MCP (Model Context Protocol) server that provides weather tools for AI assistants, built with xmcp.
Features
Tools
- get-current-weather - Get current weather conditions for any city (temperature, humidity, wind speed)
- get-forecast - Get weather forecast for 1-7 upcoming days
- compare-weather - Compare weather between two cities
Resources
weather://{city}/current- Current weather data as a resource
Prompts
- weather-summary - Generate weather summary prompts
Installation
npm install
Usage
Development
npm run dev
Production
npm run build
npm run start
Inspect with MCP Inspector
npm run inspect
Configuration
Add to your MCP client configuration:
{
"mcpServers": {
"weather": {
"command": "node",
"args": ["/path/to/weather-mcp/dist/stdio.js"]
}
}
}
API
This server uses the free Open-Meteo API for weather data. No API key required.
Tech Stack
- xmcp - MCP framework
- Zod - Schema validation
- Open-Meteo API - Weather data
License
MIT
Tools 3
get-current-weatherGet current weather conditions for any city including temperature, humidity, and wind speed.get-forecastGet weather forecast for 1-7 upcoming days.compare-weatherCompare weather between two cities.Try it
→What is the current weather in Tokyo?
→Can you give me a 5-day weather forecast for London?
→Compare the weather in New York and Los Angeles today.
→Is it going to be rainy in Paris over the next 3 days?