🌍 Planetary MCP Server

Earth Engine for Claude Desktop - Powerful satellite data analysis with simple commands

Transform Claude Desktop into a geospatial powerhouse! Access Google Earth Engine's vast satellite data catalog and perform advanced analysis directly through natural language.

✨ Features

• 🛰️ 100+ Earth Engine Tools - Access satellite data from Landsat, Sentinel, MODIS and more
• 🗺️ Interactive Maps - Generate web-based visualizations
• 🌾 Smart Crop Classification - Enhanced with automatic urban/water/vegetation detection
• 🔥 Advanced Models - Wildfire risk, flood assessment, deforestation tracking
• 🚀 3-Minute Setup - Interactive wizard handles everything
• 🌐 Cross-Platform - Works on Windows, macOS, and Linux

📦 Quick Start

1️⃣ Install

npm install -g planetary-mcp-server

2️⃣ Setup (Interactive Wizard)

planetary-mcp init

The wizard will:

• ✅ Help you get Earth Engine credentials
• ✅ Configure Claude Desktop automatically
• ✅ Test the connection

3️⃣ Use in Claude Desktop

Just restart Claude Desktop and ask:

• "Calculate NDVI for California in January 2024"
• "Create a crop classification map for Iowa"
• "Assess wildfire risk in Colorado"
• "Monitor water quality in Lake Tahoe"

🛠️ Available Tools

Core Tools

• earth_engine_data - Search and filter satellite datasets
• earth_engine_process - Calculate indices, create composites
• earth_engine_export - Export data and generate visualizations
• earth_engine_system - System operations and health checks

Specialized Models

• wildfire_risk_assessment - Analyze fire danger
• flood_risk_assessment - Evaluate flood potential
• agricultural_monitoring - Track crop health
• deforestation_detection - Monitor forest loss
• water_quality_monitoring - Assess water bodies

📋 Commands

planetary-mcp init      # Run setup wizard
planetary-mcp start     # Start Next.js server (optional)
planetary-mcp status    # Check configuration
planetary-mcp test      # Test Earth Engine connection
planetary-mcp help      # Show all commands

🔑 Getting Earth Engine Credentials

You'll need a Google Cloud service account with Earth Engine access:

1. Go to Google Cloud Console
2. Create/select a project
3. Enable "Earth Engine API"
4. Create a service account
5. Download the JSON key

The setup wizard will guide you through this process!

💡 Example Queries in Claude

Calculate Vegetation Index

"Use Earth Engine to calculate NDVI for the Amazon rainforest in December 2023"

Crop Classification

"Create a crop classification map for agricultural regions in Iowa"

Wildfire Analysis

"Assess wildfire risk in California for the last fire season"

Water Quality

"Monitor water quality changes in the Great Lakes over the past year"

🏗️ Architecture

Claude Desktop ← MCP Protocol → Planetary MCP Server
                                        ↓
                                 Earth Engine API
                                        ↓
                                 Satellite Data

🔧 Advanced Configuration

Manual Server Start

If you need the Next.js server for web visualizations:

planetary-mcp start

Custom Port

Edit ~/.planetary-mcp/config.json:

{
  "serverPort": 3000
}

🐛 Troubleshooting

Claude doesn't see the MCP

1. Restart Claude Desktop completely
2. Run planetary-mcp status to check configuration

Earth Engine authentication fails

1. Verify your service account has Earth Engine access
2. Run planetary-mcp test to diagnose

Server won't start

1. Check if port 3000 is available
2. Try planetary-mcp init to reconfigure

📚 Resources

• Documentation
• Earth Engine Catalog
• MCP Protocol

🤝 Contributing

Contributions are welcome! Please see our GitHub repository.

📄 License

MIT © Dhenenjay

Need help? Open an issue on GitHub or reach out to the community!

🌍 Empowering geospatial analysis for everyone