mcp-server-tempest 0.1.0__tar.gz

mcp_server_tempest-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+.env
+NOTES.md
+.ipynb_checkpoints/
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

mcp_server_tempest-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

mcp_server_tempest-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Brian Connelly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

mcp_server_tempest-0.1.0/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: mcp-server-tempest
+Version: 0.1.0
+Summary: MCP Server for Retrieving Tempest Weather Data
+Author-email: Brian Connelly <bdc@bconnelly.net>
+License: MIT License
+        
+        Copyright (c) 2025 Brian Connelly
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE. 
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.13
+Requires-Dist: cachetools>=6.1.0
+Requires-Dist: fastmcp>=2.9.2
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: weatherflow4py>=1.4.1
+Description-Content-Type: text/markdown
+
+# WeatherFlow Tempest MCP Server
+
+A Model Context Protocol (MCP) server that provides seamless access to WeatherFlow Tempest weather station data.
+This server enables AI assistants and applications to retrieve real-time weather observations, forecasts, and station metadata.
+
+
+## 🌤️ Features
+
+- **Real-time Weather Data**: Access current conditions from personal weather stations
+- **Weather Forecasts**: Get hourly and daily forecasts with professional meteorological models
+- **Station Management**: Discover and manage multiple weather stations
+- **Device Information**: Detailed metadata about connected weather devices
+- **Intelligent Caching**: Automatic caching with configurable TTL for optimal performance
+- **Multiple Access Methods**: Both tools (interactive queries) and resources (data access)
+- **Comprehensive Data**: Temperature, humidity, pressure, wind, precipitation, solar radiation, UV index, and lightning detection
+
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.13 or higher
+- WeatherFlow API token (get one at [tempestwx.com/settings/tokens](https://tempestwx.com/settings/tokens))
+
+### Installation
+
+While each client has its own way of specifying, you'll generally use the following values:
+
+| Field | Value |
+|-------|-------|
+| **Command** | `uvx` |
+| **Arguments** | `mcp-server-tempest` |
+| **Environment** | `WEATHERFLOW_API_TOKEN` = `<YOUR TOKEN>` |
+
+
+### Development Version
+
+If you'd like to use the latest and greatest, the server can be pulled straight from GitHub.
+Just add an additional `--from` argument:
+
+
+| Field | Value |
+|-------|-------|
+| **Command** | `uvx` |
+| **Arguments** | `--from`, `git+https://github.com/briandconnelly/mcp-server-tempest`, `mcp-server-tempest` |
+| **Environment** | `WEATHERFLOW_API_TOKEN` = `<YOUR TOKEN>` |
+
+
+## 📋 Configuration
+
+### Environment Variables
+
+| Variable | Description | Default | Required |
+|----------|-------------|---------|----------|
+| `WEATHERFLOW_API_TOKEN` | Your WeatherFlow API token | - | ✅ Yes |
+| `WEATHERFLOW_CACHE_TTL` | Cache timeout in seconds | 300 | No |
+| `WEATHERFLOW_CACHE_SIZE` | Maximum cache entries | 100 | No |
+
+
+## 🛠️ Usage
+
+### Available Tools
+
+#### `get_stations()`
+Get a list of all your weather stations and connected devices.
+
+```python
+# Get all available stations
+stations = await client.call_tool("get_stations")
+for station in stations.stations:
+    print(f"Station: {station.name} (ID: {station.station_id})")
+    print(f"Location: {station.latitude}, {station.longitude}")
+```
+
+#### `get_observation(station_id)`
+Get current weather conditions for a specific station.
+
+```python
+# Get current conditions
+obs = await client.call_tool("get_observation", {"station_id": 12345})
+current = obs.obs[0]
+print(f"Temperature: {current.air_temperature}°")
+print(f"Humidity: {current.relative_humidity}%")
+print(f"Wind: {current.wind_avg} {obs.station_units.units_wind}")
+```
+
+#### `get_forecast(station_id)`
+Get weather forecast and current conditions.
+
+```python
+# Get forecast
+forecast = await client.call_tool("get_forecast", {"station_id": 12345})
+
+# Current conditions
+current = forecast.current_conditions
+print(f"Current: {current.air_temperature}°")
+print(f"Conditions: {current.conditions}")
+
+# Today's forecast
+today = forecast.forecast.daily[0]
+print(f"High/Low: {today.air_temp_high}°/{today.air_temp_low}°")
+print(f"Rain chance: {today.precip_probability}%")
+```
+
+#### `get_station_id(station_id)`
+Get detailed information about a specific station.
+
+```python
+# Get station details
+station = await client.call_tool("get_station_id", {"station_id": 12345})
+print(f"Station: {station.name}")
+print(f"Elevation: {station.station_meta.elevation}m")
+print(f"Devices: {len(station.devices)}")
+```
+
+#### `clear_cache()`
+Clear the data cache (useful for testing).
+
+```python
+# Clear cache
+await client.call_tool("clear_cache")
+```
+
+### Available Resources
+
+The server also provides resources for data access:
+
+- `weather://tempest/stations` - List all stations
+- `weather://tempest/stations/{station_id}` - Station details
+- `weather://tempest/observations/{station_id}` - Current observations
+- `weather://tempest/forecast/{station_id}` - Weather forecast
+
+
+## 🌟 Examples
+
+### Basic Weather Check
+
+```python
+# Get your stations
+stations = await client.call_tool("get_stations")
+station_id = stations.stations[0].station_id
+
+# Get current conditions
+obs = await client.call_tool("get_observation", {"station_id": station_id})
+current = obs.obs[0]
+
+print(f"🌡️  Temperature: {current.air_temperature}°{obs.station_units.units_temp}")
+print(f"💧 Humidity: {current.relative_humidity}%")
+print(f"💨 Wind: {current.wind_avg} {obs.station_units.units_wind}")
+print(f"🌧️  Precipitation: {current.precip_accum_local_day} {obs.station_units.units_precip}")
+```
+
+### Weather Forecast
+
+```python
+# Get forecast
+forecast = await client.call_tool("get_forecast", {"station_id": station_id})
+
+# Today's weather
+today = forecast.forecast.daily[0]
+print(f"📅 Today: {today.conditions}")
+print(f"🌡️  High: {today.air_temp_high}° / Low: {today.air_temp_low}°")
+print(f"🌧️  Rain chance: {today.precip_probability}%")
+
+# Next few hours
+for hour in forecast.forecast.hourly[:6]:
+    time = datetime.fromtimestamp(hour.time)
+    print(f"🕐 {time.strftime('%H:%M')}: {hour.air_temperature}° - {hour.conditions}")
+```
+
+### Station Information
+
+```python
+# Get station details
+station = await client.call_tool("get_station_id", {"station_id": station_id})
+
+print(f"🏠 Station: {station.name}")
+print(f"📍 Location: {station.latitude}°, {station.longitude}°")
+print(f"⛰️  Elevation: {station.station_meta.elevation}m")
+print(f"🕐 Timezone: {station.timezone}")
+
+# Check device status
+for device in station.devices:
+    if device.serial_number:
+        status = "🟢 Online" if device.device_meta else "🔴 Offline"
+        print(f"📡 {device.device_type}: {status}")
+```
+
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- [WeatherFlow](https://weatherflow.com/) for providing the Tempest weather station and API
+- [Model Context Protocol](https://modelcontextprotocol.io/) for the MCP specification
+- [FastMCP](https://github.com/jlowin/fastmcp) for the MCP server framework
+
+## 📞 Support
+
+- **Issues**: [GitHub Issues](https://github.com/yourusername/mcp-server-tempest/issues)
+- **Documentation**: [WeatherFlow API Docs](https://weatherflow.github.io/Tempest/api/)
+- **Community**: [WeatherFlow Community](https://community.weatherflow.com/)

mcp_server_tempest-0.1.0/README.md

@@ -0,0 +1,213 @@
+# WeatherFlow Tempest MCP Server
+
+A Model Context Protocol (MCP) server that provides seamless access to WeatherFlow Tempest weather station data.
+This server enables AI assistants and applications to retrieve real-time weather observations, forecasts, and station metadata.
+
+
+## 🌤️ Features
+
+- **Real-time Weather Data**: Access current conditions from personal weather stations
+- **Weather Forecasts**: Get hourly and daily forecasts with professional meteorological models
+- **Station Management**: Discover and manage multiple weather stations
+- **Device Information**: Detailed metadata about connected weather devices
+- **Intelligent Caching**: Automatic caching with configurable TTL for optimal performance
+- **Multiple Access Methods**: Both tools (interactive queries) and resources (data access)
+- **Comprehensive Data**: Temperature, humidity, pressure, wind, precipitation, solar radiation, UV index, and lightning detection
+
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.13 or higher
+- WeatherFlow API token (get one at [tempestwx.com/settings/tokens](https://tempestwx.com/settings/tokens))
+
+### Installation
+
+While each client has its own way of specifying, you'll generally use the following values:
+
+| Field | Value |
+|-------|-------|
+| **Command** | `uvx` |
+| **Arguments** | `mcp-server-tempest` |
+| **Environment** | `WEATHERFLOW_API_TOKEN` = `<YOUR TOKEN>` |
+
+
+### Development Version
+
+If you'd like to use the latest and greatest, the server can be pulled straight from GitHub.
+Just add an additional `--from` argument:
+
+
+| Field | Value |
+|-------|-------|
+| **Command** | `uvx` |
+| **Arguments** | `--from`, `git+https://github.com/briandconnelly/mcp-server-tempest`, `mcp-server-tempest` |
+| **Environment** | `WEATHERFLOW_API_TOKEN` = `<YOUR TOKEN>` |
+
+
+## 📋 Configuration
+
+### Environment Variables
+
+| Variable | Description | Default | Required |
+|----------|-------------|---------|----------|
+| `WEATHERFLOW_API_TOKEN` | Your WeatherFlow API token | - | ✅ Yes |
+| `WEATHERFLOW_CACHE_TTL` | Cache timeout in seconds | 300 | No |
+| `WEATHERFLOW_CACHE_SIZE` | Maximum cache entries | 100 | No |
+
+
+## 🛠️ Usage
+
+### Available Tools
+
+#### `get_stations()`
+Get a list of all your weather stations and connected devices.
+
+```python
+# Get all available stations
+stations = await client.call_tool("get_stations")
+for station in stations.stations:
+    print(f"Station: {station.name} (ID: {station.station_id})")
+    print(f"Location: {station.latitude}, {station.longitude}")
+```
+
+#### `get_observation(station_id)`
+Get current weather conditions for a specific station.
+
+```python
+# Get current conditions
+obs = await client.call_tool("get_observation", {"station_id": 12345})
+current = obs.obs[0]
+print(f"Temperature: {current.air_temperature}°")
+print(f"Humidity: {current.relative_humidity}%")
+print(f"Wind: {current.wind_avg} {obs.station_units.units_wind}")
+```
+
+#### `get_forecast(station_id)`
+Get weather forecast and current conditions.
+
+```python
+# Get forecast
+forecast = await client.call_tool("get_forecast", {"station_id": 12345})
+
+# Current conditions
+current = forecast.current_conditions
+print(f"Current: {current.air_temperature}°")
+print(f"Conditions: {current.conditions}")
+
+# Today's forecast
+today = forecast.forecast.daily[0]
+print(f"High/Low: {today.air_temp_high}°/{today.air_temp_low}°")
+print(f"Rain chance: {today.precip_probability}%")
+```
+
+#### `get_station_id(station_id)`
+Get detailed information about a specific station.
+
+```python
+# Get station details
+station = await client.call_tool("get_station_id", {"station_id": 12345})
+print(f"Station: {station.name}")
+print(f"Elevation: {station.station_meta.elevation}m")
+print(f"Devices: {len(station.devices)}")
+```
+
+#### `clear_cache()`
+Clear the data cache (useful for testing).
+
+```python
+# Clear cache
+await client.call_tool("clear_cache")
+```
+
+### Available Resources
+
+The server also provides resources for data access:
+
+- `weather://tempest/stations` - List all stations
+- `weather://tempest/stations/{station_id}` - Station details
+- `weather://tempest/observations/{station_id}` - Current observations
+- `weather://tempest/forecast/{station_id}` - Weather forecast
+
+
+## 🌟 Examples
+
+### Basic Weather Check
+
+```python
+# Get your stations
+stations = await client.call_tool("get_stations")
+station_id = stations.stations[0].station_id
+
+# Get current conditions
+obs = await client.call_tool("get_observation", {"station_id": station_id})
+current = obs.obs[0]
+
+print(f"🌡️  Temperature: {current.air_temperature}°{obs.station_units.units_temp}")
+print(f"💧 Humidity: {current.relative_humidity}%")
+print(f"💨 Wind: {current.wind_avg} {obs.station_units.units_wind}")
+print(f"🌧️  Precipitation: {current.precip_accum_local_day} {obs.station_units.units_precip}")
+```
+
+### Weather Forecast
+
+```python
+# Get forecast
+forecast = await client.call_tool("get_forecast", {"station_id": station_id})
+
+# Today's weather
+today = forecast.forecast.daily[0]
+print(f"📅 Today: {today.conditions}")
+print(f"🌡️  High: {today.air_temp_high}° / Low: {today.air_temp_low}°")
+print(f"🌧️  Rain chance: {today.precip_probability}%")
+
+# Next few hours
+for hour in forecast.forecast.hourly[:6]:
+    time = datetime.fromtimestamp(hour.time)
+    print(f"🕐 {time.strftime('%H:%M')}: {hour.air_temperature}° - {hour.conditions}")
+```
+
+### Station Information
+
+```python
+# Get station details
+station = await client.call_tool("get_station_id", {"station_id": station_id})
+
+print(f"🏠 Station: {station.name}")
+print(f"📍 Location: {station.latitude}°, {station.longitude}°")
+print(f"⛰️  Elevation: {station.station_meta.elevation}m")
+print(f"🕐 Timezone: {station.timezone}")
+
+# Check device status
+for device in station.devices:
+    if device.serial_number:
+        status = "🟢 Online" if device.device_meta else "🔴 Offline"
+        print(f"📡 {device.device_type}: {status}")
+```
+
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- [WeatherFlow](https://weatherflow.com/) for providing the Tempest weather station and API
+- [Model Context Protocol](https://modelcontextprotocol.io/) for the MCP specification
+- [FastMCP](https://github.com/jlowin/fastmcp) for the MCP server framework
+
+## 📞 Support
+
+- **Issues**: [GitHub Issues](https://github.com/yourusername/mcp-server-tempest/issues)
+- **Documentation**: [WeatherFlow API Docs](https://weatherflow.github.io/Tempest/api/)
+- **Community**: [WeatherFlow Community](https://community.weatherflow.com/)

mcp_server_tempest-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "mcp-server-tempest"
+version = "0.1.0"
+description = "MCP Server for Retrieving Tempest Weather Data"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "Brian Connelly", email = "bdc@bconnelly.net" }
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "cachetools>=6.1.0",
+    "fastmcp>=2.9.2",
+    "pydantic>=2.11.7",
+    "weatherflow4py>=1.4.1",
+]
+
+[project.scripts]
+mcp-server-tempest = "mcp_server_tempest:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

mcp_server_tempest-0.1.0/src/mcp_server_tempest/__init__.py

@@ -0,0 +1,9 @@
+from .server import mcp
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()