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.
- Open your Claude Desktop configuration file:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Mac:
- Add the server under the
mcpServersobject:
{
"mcpServers": {
"weather": {
"command": "arunsiv-weather-mcp-server",
"args": []
}
}
}
Local Development & Testing
- Install dependencies and the package locally:
pip install -e .
- Test using the official MCP Inspector:
npx @modelcontextprotocol/inspector arunsiv-weather-mcp-server
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file arunsiv_weather_mcp_server-1.0.0.tar.gz.
File metadata
- Download URL: arunsiv_weather_mcp_server-1.0.0.tar.gz
- Upload date:
- Size: 1.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0fb718bca713af8967d30b00df143cb4e3d0d2052bea2948651cb75dbd3a8ba8
|
|
| MD5 |
80a85a31baa7cc57bbdf2b9fa057a4d5
|
|
| BLAKE2b-256 |
a617819dd0286ad87cae6e1ce15609ba61181aaaa1ccfcd62e194060e3cfc593
|
File details
Details for the file arunsiv_weather_mcp_server-1.0.0-py3-none-any.whl.
File metadata
- Download URL: arunsiv_weather_mcp_server-1.0.0-py3-none-any.whl
- Upload date:
- Size: 3.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e9dce40c5ca565fd869cd63dfe170cf0270566b0e8e1536396db9cb344d4f8d
|
|
| MD5 |
9d72a2bfdc5861e5454c5f83571370f1
|
|
| BLAKE2b-256 |
74a66978f84cee08fa9193465ad504cb7274103d59b81222819eb1c8eaf1f730
|