┌─────────────────────────────────────────────────────────────────┐
│                     CLIENT LAYER                                │
│         Claude Desktop / Streamlit Dashboard / API              │
└──────────────────────────┬──────────────────────────────────────┘
                           │ MCP Protocol (stdio/SSE)
┌──────────────────────────▼──────────────────────────────────────┐
│                    MCP SERVER (FastAPI)                         │
│    ┌──────────┐    ┌──────────┐    ┌──────────┐                │
│    │  Tools   │    │  Auth    │    │  Queue   │                │
│    │  Router  │    │  Layer   │    │ (Celery) │                │
│    └──────────┘    └──────────┘    └──────────┘                │
└──────────────────────────┬──────────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────────┐
│                   PROCESSING ENGINE                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐             │
│  │  Imagery    │  │  ML Models  │  │  Visualize  │             │
│  │  Fetcher    │  │  Pipeline   │  │  Engine     │             │
│  └─────────────┘  └─────────────┘  └─────────────┘             │
└──────────────────────────┬──────────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────────┐
│                    DATA LAYER                                   │
│    ┌──────────┐    ┌──────────┐    ┌──────────┐                │
│    │ Postgres │    │  Redis   │    │  MinIO   │                │
│    │ +PostGIS │    │  Cache   │    │ Storage  │                │
│    └──────────┘    └──────────┘    └──────────┘                │
└─────────────────────────────────────────────────────────────────┘

git clone https://github.com/yourusername/geosight-mcp.git
cd geosight-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -e ".[dev]"

cp .env.example .env
# Edit .env with your API keys

# Development mode
docker-compose up -d redis postgres minio

# Run MCP server
python -m geosight.server

# Or run everything with Docker
docker-compose up -d

{
  "mcpServers": {
    "geosight": {
      "command": "python",
      "args": ["-m", "geosight.server"],
      "cwd": "/path/to/geosight-mcp",
      "env": {
        "SENTINEL_HUB_CLIENT_ID": "your-client-id",
        "SENTINEL_HUB_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

# Example usage through Claude
"Find Sentinel-2 imagery for New Delhi from last month"

# Returns: NDVI map + statistics
"Calculate NDVI for agricultural region near Punjab"

# Returns: Water mask + area calculations
"Show water bodies in Kerala during monsoon season"

# Returns: Classification map + percentages
"Classify land cover for Bangalore metropolitan area"

# Returns: Change map + statistics
"Show construction changes in Dubai between 2020 and 2024"

# Returns: Detected objects with bounding boxes
"Detect ships in Mumbai harbor"

# Returns: Downloadable report
"Generate environmental report for Amazon rainforest region"

# Build and run all services
docker-compose -f docker-compose.prod.yml up -d

# Check logs
docker-compose logs -f geosight-mcp

# Railway
railway up

# Fly.io
fly launch
fly deploy

kubectl apply -f k8s/

geosight-mcp/
├── src/
│   └── geosight/
│       ├── __init__.py
│       ├── server.py           # MCP server entry point
│       ├── tools/              # MCP tool implementations
│       │   ├── __init__.py
│       │   ├── imagery.py      # Image search & fetch
│       │   ├── indices.py      # NDVI, NDWI calculations
│       │   ├── classification.py # Land cover classification
│       │   ├── change_detection.py
│       │   ├── object_detection.py
│       │   └── reports.py      # Report generation
│       ├── models/             # ML models
│       │   ├── __init__.py
│       │   ├── land_cover.py
│       │   ├── change_detector.py
│       │   └── object_detector.py
│       ├── services/           # External service integrations
│       │   ├── __init__.py
│       │   ├── sentinel_hub.py
│       │   ├── earth_engine.py
│       │   └── storage.py
│       └── utils/              # Utilities
│           ├── __init__.py
│           ├── geo.py          # Geospatial utilities
│           ├── visualization.py
│           └── cache.py
├── tests/
├── config/
├── scripts/
├── dashboard/                  # Streamlit dashboard
├── docs/
├── docker-compose.yml
├── Dockerfile
├── pyproject.toml
└── README.md

# Run all tests
pytest

# With coverage
pytest --cov=geosight --cov-report=html

# Integration tests
pytest tests/integration/ -v