Axion MCP

🚀 Axion-MCP

Advanced Earth Engine MCP Server - An enterprise-grade geospatial analysis platform for Claude Desktop

Transform Claude Desktop into a powerful geospatial analysis workstation with direct access to Google Earth Engine's massive satellite data catalog and advanced processing capabilities.

🚀 Quick Start

Axion-MCP enables you to turn Claude Desktop into a high - performance geospatial analysis platform, allowing you to access Google Earth Engine's rich satellite data and advanced processing capabilities.

✨ Features

🛰️ Consolidated Super Tools (6 in Total)

• earth_engine_data: Search, filter, and access satellite datasets.
• earth_engine_process: Perform advanced image processing and analysis.
• earth_engine_export: Export data to various formats and destinations.
• earth_engine_system: Manage and configure the system.
• earth_engine_map: Provide interactive web - based visualization.
• crop_classification: Conduct ML - powered crop type classification.

🌐 Geospatial Models (5 in Total)

• 🔥 Wildfire Risk Assessment: Conduct multi - factor fire danger analysis.
• 🌊 Flood Risk Assessment: Build hydrological and terrain - based flood models.
• 🌾 Agricultural Monitoring: Estimate crop health and yield.
• 🌳 Deforestation Detection: Track forest changes.
• 💧 Water Quality Monitoring: Analyze water bodies.

🚀 Technical Capabilities

• 30+ Satellite Datasets: Including Landsat, Sentinel, MODIS, etc.
• Vegetation Indices: Such as NDVI, NDWI, EVI, SAVI, NBR.
• Cloud - Free Composites: Automatically mask clouds and create mosaics.
• Time Series Analysis: Detect temporal changes.
• Export Options: Export to Google Drive, Cloud Storage, Earth Engine Assets.
• Interactive Maps: Provide web - based visualization with multiple layers.

📦 Installation

Prerequisites

• Node.js 18+
• A Google Cloud account with Earth Engine access
• The Claude Desktop application

Quick Setup

1. Clone the repository

git clone https://github.com/Dhenenjay/Axion-MCP.git
cd Axion-MCP

2. Install dependencies

npm install

3. Build the project

npm run build
npm run build:next

4. Set up Earth Engine credentials

# Set your service account key path
export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/service-account-key.json"

5. Start the server

npm run start:next

6. Configure Claude Desktop Add the following to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "axion-mcp": {
      "command": "node",
      "args": ["C:\\path\\to\\Axion-MCP\\mcp-sse-complete.cjs"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "path/to/credentials.json"
      }
    }
  }
}

💻 Usage Examples

In Claude Desktop

Calculate vegetation index:

"Use Earth Engine to calculate NDVI for California in the last month"

Wildfire risk assessment:

"Analyze wildfire risk for Colorado considering vegetation, moisture, and terrain"

Crop classification:

"Create a crop type map for Iowa using recent Sentinel - 2 imagery"

Water quality monitoring:

"Monitor water quality changes in Lake Tahoe over the past year"

📚 Documentation

📊 Architecture

Claude Desktop ← MCP Protocol → Axion-MCP Server
                                      ↓
                                 SSE Bridge
                                      ↓
                                Next.js API
                                      ↓
                              Earth Engine API
                                      ↓
                              Satellite Data

🛠️ Available Operations

Data Operations

• Search satellite datasets
• Filter by date, location, cloud cover
• Get dataset information
• Convert place names to coordinates

Processing Operations

• Calculate vegetation indices
• Create cloud - free composites
• Perform terrain analysis
• Conduct time series analysis
• Execute statistical operations

Export Operations

• Generate visualization thumbnails
• Export to Google Drive
• Export to Cloud Storage
• Save as Earth Engine Assets

📈 Performance

• Optimized for stability: Reduced from 30+ tools to 6 consolidated super tools.
• Caching system: Smart caching for repeated operations.
• Timeout handling: Graceful handling of long - running operations.
• Parallel processing: Support for batch operations.

🔒 Security

• Service account authentication
• Secure credential handling
• Rate limiting support
• Input validation

📚 Reference Documents

• Earth Engine Catalog
• MCP Protocol Specification
• API Reference

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines first.

📄 License

MIT © 2024 Dhenenjay

🙏 Acknowledgments

• Google Earth Engine team
• Anthropic MCP team
• Open source community

Need help? Open an issue or reach out!