MCP Weather Server Demo is an MCP server that provides meteorological data by connecting to the Open-Meteo API and public geocoding endpoints. Designed as an educational implementation for developers learning the Model Context Protocol, it demonstrates how to structure tools and perform schema validation using the official TypeScript SDK and Zod. AI assistants connected to this server can accept city names as arguments and retrieve real-time weather information without requiring external API keys. It allows software engineers, students, and agent builders to evaluate how external REST APIs can be wrapped into standardized tool interfaces for LLMs. Users running Claude Desktop, development scripts, or the MCP Inspector can invoke the weather tool directly to inspect payload structures, observe stdio transport interactions, and test model tool-calling workflows. In addition to serving live weather metrics, the project functions as a minimal template for constructing, testing, and troubleshooting custom Node.js and TypeScript MCP servers.
Category: Maps, Weather & Local Data
Tags: forecast, meteorology, open-meteo, weather
npm install. 3. Execute the server directly using npx tsx main.ts. 4. To test and debug the server using the web inspector, run npx -y @modelcontextprotocol/inspector npx -y tsx main.ts and connect via STDIO using the generated proxy authentication token. 5. To register the server in your MCP client configuration file, add an entry under mcpServers specifying npx as the command with the arguments ["tsx", "main.ts"] alongside your target repository path.Part of MCP Servers
MCP Weather Server Demo is a sample Model Context Protocol server written in TypeScript. It connects AI clients to the Open-Meteo API, providing a tool that accepts a city name and returns current weather conditions and location geocoding data.
It provides a tool named fetch-weather that accepts a city name string. The server contacts public geocoding services to resolve geographic coordinates, queries the Open-Meteo service, and returns current weather details directly to the client.
It works with any Model Context Protocol client supporting stdio communication, including Claude Desktop and custom client implementations. It can also be inspected and tested locally through the official MCP Inspector utility.
Yes, this project is open source. According to the project documentation, it is licensed under the MIT License, allowing developers to review, modify, and extend the source code freely.