Wildfire MCP Server

1# Wildfire MCP Server
2 
3A Model Context Protocol (MCP) server for detecting, monitoring, and analyzing potential wildfires globally using multiple data sources including NASA FIRMS, OpenWeatherMap, and Google Earth Engine.
4 
5## Overview
6 
7This MCP server provides AI assistants with tools to detect and analyze wildfire activity anywhere in the world by integrating real-time satellite data, weather forecasts, air pollution metrics, and geographical information. It's designed to help identify potential wildfires and assess their environmental impact.
8 
9## Features
10 
11- **Fire Detection**: Query NASA FIRMS (Fire Information for Resource Management System) for active fire hotspots
12- **Weather Forecasting**: Get 5-day weather forecasts for specific locations
13- **Air Pollution Monitoring**: Access current and historical air pollution data
14- **Reverse Geocoding**: Convert coordinates to human-readable addresses
15- **Fire Fuel Assessment**: Determine if a location contains potential wildfire fuel based on land cover data
16- **Customizable Filtering**: Filter fires by radiative power, brightness temperature, and geographic boundaries
17 
18## Prerequisites
19 
20Configure API keys (if required):
21 
22- NASA FIRMS Map Key
23- OpenWeatherMap API Key
24- Google Earth Engine credentials (if applicable)
25 
26## Available Tools
27 
28### `get_potential_wildfires`
29 
30Get potential wildfires for a specific date using NASA FIRMS data.
31 
32**Parameters:**
33 
34- `date` (str, optional): Date in YYYY-MM-DD format. Defaults to current date.
35- `frp` (float): Fire Radiative Power threshold (default: 1)
36- `bright_ti4` (float): Brightness temperature threshold (default: 50)
37- `in_iran` (bool): If True, filters fires to only show those within Iran's borders (useful for Iran-specific monitoring)
38- `bounding_box` (BoundingBox, optional): Custom bounding box to limit search area to any geographic region
39 
40### `get_address`
41 
42Get the address for given coordinates.
43 
44**Parameters:**
45 
46- `latitude` (float): Latitude of the location
47- `longitude` (float): Longitude of the location
48 
49### `get_weather_forecast`
50 
51Get 5-day weather forecast with 3-hour intervals.
52 
53**Parameters:**
54 
55- `latitude` (float): Latitude of the location
56- `longitude` (float): Longitude of the location
57 
58### `get_current_air_pollution_data`
59 
60Fetch current air pollution data.
61 
62**Parameters:**
63 
64- `latitude` (float): Latitude of the location
65- `longitude` (float): Longitude of the location
66 
67### `get_historical_air_pollution_data`
68 
69Fetch historical air pollution data for a date range.
70 
71**Parameters:**
72 
73- `latitude` (float): Latitude of the location
74- `longitude` (float): Longitude of the location
75- `start_date` (str): Start of period (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
76- `end_date` (str): End of period (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
77 
78### `is_fire_fuel`
79 
80Check if a location contains potential wildfire fuel.
81 
82**Parameters:**
83 
84- `latitude` (float): Latitude of the location
85- `longitude` (float): Longitude of the location
86 
87**Returns:** Boolean indicating if location is in a potential wildfire fuel area
88 
89## Testing
90 
91### Using MCP Inspector
92 
93```bash
94npx @modelcontextprotocol/inspector python wildfire_mcp_server.py
95```
96 
97The timeout for the client needs to be increased since some data fetching operations can take a while. This can be done either by setting the config in the UI or by setting the following environment variables:
98 
99```bash
100export MCP_SERVER_REQUEST_TIMEOUT=9000000
101export MCP_REQUEST_MAX_TOTAL_TIMEOUT=9000000
102export MCP_REQUEST_TIMEOUT_RESET_ON_PROGRESS=true
103```
104 
105**Good date to test:** 2025-11-21 (known active fire day)
106 
107### Running Test Scripts
108 
109```bash
110# Test individual components
111uv run scripts/test_nasa_firms.py
112uv run scripts/test_main_functionality.py
113uv run scripts/test_overpass.py
114```
115 
116## Architecture
117 
118The project is organized into several layers:
119 
120- **`wildfire_mcp_server.py`**: Main server entry point with MCP tool definitions
121- **`src/agents/`**: High-level agent classes that orchestrate domain services
122  - `LikelyFireAgent`: Fire detection and filtering
123  - `FireFuelAgent`: Land cover and fuel assessment
124  - `AddressAgent`: Reverse geocoding
125  - `WeatherForecastAgent`: Weather data retrieval
126  - `AirPollutionAgent`: Air quality data
127- **`src/domains/`**: Domain-specific integrations
128  - `nasa_firms/`: NASA FIRMS fire data API
129  - `open_weather_map/`: Weather and air pollution APIs
130  - `google_earth_engine/`: Land cover data
131  - `overpass/`: OpenStreetMap data
132  - `planetary_computer/`: Microsoft Planetary Computer integration
133 
134## Data Sources
135 
136- **NASA FIRMS**: Active fire data from MODIS and VIIRS satellites
137- **OpenWeatherMap**: Weather forecasts and air pollution metrics
138- **Google Earth Engine**: Land cover classification
139- **OpenStreetMap (Overpass)**: Geographic and administrative boundaries
140 
141## License
142 
143This project is licensed under a custom Evaluation and Non-Production License. See the [LICENSE](LICENSE) file for details.
144 
145**Note**: Production use requires explicit written approval from the copyright holder.
146 
147## Contributing
148 
149Contributions are welcome for evaluation and improvement purposes. Please ensure any pull requests maintain the evaluation-only nature of this license.
150 
151## Disclaimer
152 
153This tool is designed for wildfire monitoring and research purposes. Fire detection data should be verified with official sources before taking any action. The accuracy of fire detection depends on satellite data availability and environmental conditions.
154 
155## Support
156 
157For issues, questions, or production licensing inquiries, please open an issue on the repository or contact the maintainers directly.
158