# 🌍 Geospatial MCP Server & AI Assistant
**Author:** [Glenn Mossy](https://github.com/gmossy) | [LinkedIn](https://www.linkedin.com/in/glenn-mossy)
**License:** MIT
**Tech Stack:**
A powerful **Model Context Protocol (MCP)** server designed for advanced geospatial analysis, 3D terrain visualization, and autonomous drone mission planning. This project integrates real-time geospatial tools with an AI Assistant powered by open-source LLMs.
*(Above: 3D Visualization of a Drone Flight Path over Terrain)*
## ✨ Key Features
### 🎮 Mission Control Center
* **Rim Survey** – High‑altitude canyon rim survey.
* **Grand Canyon Tour** – Scenic route through the canyon.
* **River Run** – Low‑altitude river‑following flight.
* **Drone Speed** – Adjustable speed slider with flight‑time estimate.
* **Line of Sight** – Connectivity checks for towers and observation posts.
* **3D Visualization** – Interactive terrain and path rendering.
## 🚀 Proposed UI Upgrade
* **Mission Control** – A future enhancement that will provide an intuitive dashboard for planning, visualizing, and analyzing drone missions (Rim Survey, Grand Canyon Tour, River Run, etc.). This upgrade will include speed controls, flight‑time estimates, and richer 3D visualizations.
### 🤖 AI Geospatial Assistant
* **Natural Language Interface**: Chat with your geospatial data using models like `Qwen/Qwen2.5-72B-Instruct` (via Hugging Face).
* **Tool Use**: The AI can autonomously call tools to answer complex questions:
* *"Can a tower at A see a rover at B?"*
* *"Generate a heatmap for this area."*
* *"Plan a route from X to Y."*
* **Visual Responses**: The assistant can generate and display terrain heatmaps directly in the chat.
### 🛠️ Geospatial Tool Suite
* **Elevation**: Query high-resolution elevation data (DTED/SRTM) for any coordinate.
* **Line of Sight**: Calculate visibility between any two points on the globe.
* **Heatmaps**: Render visual elevation gradients for situational awareness.
* **Distance & MGRS**: Utilities for distance calculation and coordinate conversion (Lat/Lon <-> MGRS).
## 🚀 Getting Started
### Prerequisites
* **Docker** (Recommended) OR Python 3.11+
* **Hugging Face API Token** (Free) for the AI Assistant.
### Quick Start (Docker)
1. **Clone the Repository**:
```bash
git clone https://github.com/gmossy/geo-mcp-server.git
cd geo-mcp-server
```
2. **Configure Environment**:
Create a `.env` file in the root directory (this file is ignored by Git). Add your Hugging Face API token:
```bash
HF_TOKEN=hf_YourHuggingFaceTokenHere
```
The `.env` file allows the application to load the token at runtime without hard‑coding credentials.
3. **Build and Run**:
```bash
make build
make run
```
4. **Access the Dashboard**:
Open [http://localhost:7860](http://localhost:7860) in your browser.
### Local Development
#### Option A: Standard Pip
1. **Install Dependencies**:
```bash
pip install -r requirements.txt
```
2. **Run Server**:
```bash
./start.sh
```
#### Option B: Using `uv` (Recommended for Speed)
[uv](https://github.com/astral-sh/uv) is an extremely fast Python package installer and resolver.
1. **Install uv** (if not installed):
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
2. **Create a Virtual Environment**:
```bash
uv venv
source .venv/bin/activate
```
3. **Install Dependencies**:
```bash
uv pip install -r requirements.txt
```
4. **Run Server**:
```bash
./start.sh
```
## 📂 Project Structure
* `gradio_dashboard.py`: The main UI application (Gradio) featuring the Dashboard, AI Assistant, and Mission Control.
* `server.py`: The core FastAPI server implementing the MCP protocol and geospatial logic.
* `bridge.py`: An adapter to connect this server to **Claude Desktop** or other MCP clients.
* `dted/`: Directory for storing elevation data tiles (DTED/SRTM).
* `sample_routes/`: GeoJSON files defining mission paths.
* `scripts/`: Helper utilities for data downloading and testing.
## 🔌 Connecting to Claude Desktop
You can use this server as a tool provider for Claude Desktop.
1. Ensure the server is running.
2. Configure Claude Desktop to use `bridge.py`:
```json
"geo-server": {
"command": "python",
"args": ["/absolute/path/to/geo-mcp-server/bridge.py"]
}
```
## 📸 Screenshots
### Mission Control
*The Mission Control tab showing the Rim Survey mission visualization and report.*
### AI Assistant
*(Placeholder: Screenshot of the AI Assistant generating a heatmap)*
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🛠️ Build Information
- **Google Antigravity** Version: 1.11.5
- **VSCode OSS** Version: 1.104.0
- **Commit**: afdb915a7890576374cec17dccf6d91249170a86
- **Date**: 2025-11-20T07:11:11.677Z
- **Electron**: 37.3.1
- **Chromium**: 138.0.7204.235
- **Node.js**: 22.18.0
- **V8**: 13.8.258.31-electron.0
- **OS**: Darwin x64 24.6.0
- **Language Server CL**: 834602842
---
*Created by Glenn Mossy*
