Skip to main content

MCP server providing weather by zip code

Project description

arunsiv-weather-mcp-server

A Model Context Protocol (MCP) server that provides current weather data for any 5-digit US zip code.

Built with Python using the official mcp SDK, this server exposes a get_weather tool that can be used by AI assistants (like Claude) to dynamically retrieve weather conditions.

Features

  • Zip Code Geocoding: Converts 5-digit US zip codes into latitude and longitude using the free Zippopotam API.
  • Current Weather Data: Fetches the current temperature (°F) and wind speed (mph) using the free Open-Meteo API.
  • Zero Configuration: No API keys are required to run this server.

Installation

Install via pip:

pip install arunsiv-weather-mcp-server

Usage with Claude Desktop

To use this server with Claude Desktop, add it to your Claude configuration file.

  1. Open your Claude Desktop configuration file:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the server under the mcpServers object:
{
  "mcpServers": {
    "weather": {
      "command": "arunsiv-weather-mcp-server",
      "args": []
    }
  }
}

Local Development & Testing

  1. Install dependencies and the package locally:
    pip install -e .
    
  2. Test using the official MCP Inspector:
    npx @modelcontextprotocol/inspector arunsiv-weather-mcp-server
    

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

arunsiv_weather_mcp_server-1.0.0.tar.gz (1.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

arunsiv_weather_mcp_server-1.0.0-py3-none-any.whl (3.4 kB view details)

Uploaded Python 3

File details

Details for the file arunsiv_weather_mcp_server-1.0.0.tar.gz.

File metadata

File hashes

Hashes for arunsiv_weather_mcp_server-1.0.0.tar.gz
Algorithm Hash digest
SHA256 0fb718bca713af8967d30b00df143cb4e3d0d2052bea2948651cb75dbd3a8ba8
MD5 80a85a31baa7cc57bbdf2b9fa057a4d5
BLAKE2b-256 a617819dd0286ad87cae6e1ce15609ba61181aaaa1ccfcd62e194060e3cfc593

See more details on using hashes here.

File details

Details for the file arunsiv_weather_mcp_server-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for arunsiv_weather_mcp_server-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2e9dce40c5ca565fd869cd63dfe170cf0270566b0e8e1536396db9cb344d4f8d
MD5 9d72a2bfdc5861e5454c5f83571370f1
BLAKE2b-256 74a66978f84cee08fa9193465ad504cb7274103d59b81222819eb1c8eaf1f730

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page