mcp-weather-server-demo

MCP Weather Server

A simple Model Context Protocol (MCP) server that provides real-time weather data to AI agents like GitHub Copilot.

Quick Start

Clone the repository:

git clone https://github.com/debs-obrien/mcp-weather-server-demo.git
cd mcp-weather-server-demo

1. Install Dependencies

npm install

2. Run the Server

Test with MCP Inspector:

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts

3. Use with VS Code

1. Open the mcp.jsonfile in .vscode folder
2. Click the start server button above line 4
3. Open Chat mode and select agent and choose a modal that supports MCPs such as Claude Sonnet
4. Type or speak into the chat and ask it what the weather is like in your city

Features

• 🌤️ Real-time weather data for any city
• 🌍 No API key required (uses Open-Meteo)
• 🤖 Works with GitHub Copilot and other MCP-compatible AI tools
• ⚡ Easy to test with MCP Inspector

Usage Examples

Ask GitHub Copilot:

• "What's the weather like in Tokyo?"
• "How's the weather in London today?"
• "Give me the current weather for Paris"

How It Works

The server provides a get-weather tool that:

1. Converts city names to coordinates using geocoding
2. Fetches current weather data from Open-Meteo API
3. Returns structured data that AI agents can format beautifully

Code Structure

// Creates MCP server with weather tool
const server = new McpServer({
  name: "Weather Server",
  version: "1.0.0"
});

// Defines the get-weather tool
server.tool('get-weather', 'Tool to get the weather of a city', ...);

// Connects via stdio transport
const transport = new StdioServerTransport();
server.connect(transport);

Dependencies

• @modelcontextprotocol/sdk - MCP server framework
• zod - Schema validation

API Used

• Open-Meteo - Free weather API with no authentication required

Read the full Blog post

Building Your First MCP Weather Server: A Complete Tutorial

Watch the Demo