brbousnguar/mcp-complete-weather-server

Weather MCP Server Powered by the Open-Meteo API

This MCP server interfaces with the Open-Meteo API and offers tools to fetch current weather conditions and weather forecasts for any location worldwide.

Requirements

• uv:
  • macOS via Homebrew:

  brew install uv
  

  • Windows via WinGet:

  winget install --id=astral-sh.uv  -e
  

• Visual Studio Code or another code editor
• For testing in Claude:
  • Claude.ai account (MCP support is available for all account types)
  • Claude Desktop app, available for macOS and Windows

Development

1. Set up the uv environment

In terminal:

uv sync

2. Start the virtual environment

In terminal:

source .venv/bin/activate

NOTE: To stop the virtual environment:

deactivate

3. Set the VS Code python environment

1. Open the Command Palette Shift + CMD/CTRL + P
2. Select "Python: Set Project Environment
3. Choose mcp-open-meteo venv

4. Run MCP server in dev mode with the MCP Inspector

uv run mcp dev mcp_open_meteo/server.py

Run MCP server in VS Code

1. Open the Command Palette Shift + CMD/CTRL + P

2. Select "MCP: Open User Configuration". This opens mcp.json

3. In mcp.json:

{
  "servers": {
    "weather-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/weather-server",
        "mcp-open-meteo"
      ]
    }
  },
  "inputs": []
}

Run MCP server in Claude Desktop

Automatic install

In terminal:

uv run mcp install mcp_open_meteo/server.py

Manual install

1. Open claude_desktop_config.js in an editor:

File location:

• MacOS / Linux ~/Library/Application/Support/Claude/claude_desktop_config.json
• Windows AppData\Claude\claude_desktop_config.json

2. Find the full path to uv:

• MacOS / Linux:

which uv

• Windows:

where uv

2. In claude_desktop_config.js

{
  "mcpServers": {
    "Open-Meteo Weather": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/absolute/path/to/weather-server/mcp_open_meteo/server.py"
      ]
    }
  }
 }