MCP Weather Server for 195 Countries

A collection of Model Context Protocol (MCP) servers that fetch current weather data for 195 countries using the Open-Meteo API.

What is MCP?

Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It enables seamless integration between LLM applications (like Claude Desktop, IDEs, or AI tools) and external data sources or tools.

Deployment

Render -> shayanrais.gt

Key Concepts

• MCP Server: A program that exposes specific capabilities (tools, resources, prompts) to MCP clients
• MCP Client: An application (like Claude Desktop) that connects to MCP servers to access their capabilities
• Transport Types:
  • stdio (command-based): Server runs as a subprocess, communicates via standard input/output
  • Streamable HTTP: Server runs as an HTTP service, uses the modern MCP protocol for communication

Available Implementations

This repository provides two MCP server implementations:

1. HTTP Server (Python)

Type: Streamable HTTP (FastMCP 2.3+) Language: Python Port: 8003

{
  "mcpServers": {
    "weather-mcp-shayan": {
      "serverUrl": "http://localhost:8003/mcp",
      "description": "Weather data for 195 countries from Open-Meteo API"
    }
  }
}

→ View HTTP Implementation Details

2. Command Server (Python)

Type: stdio (command-based) Language: Python

{
  "mcpServers": {
    "weather-mcp-shayan-command": {
      "command": "python3",
      "args": ["/absolute/path/to/command/server-command.py"]
    }
  }
}

→ View Command Implementation Details

Tools Available

Both servers expose 195 weather tools (one per country):

• get_{country}_weather_shayan: Fetches current weather for the specified country's capital (e.g., get_india_weather_shayan, get_france_weather_shayan)

Quick Start

Choose the implementation that best fits your needs:

HTTP Server (Python):

cd http
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip3 install -r requirements.txt
python3 server.py

Command Server (Python):

cd command
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip3 install -r requirements.txt
python3 server-command.py