🌍 axion-mcp-bridge

Universal bridge to connect any MCP client to Axion Earth Engine server

🚀 Quick Start (1 minute setup!)

For Any MCP Client (Claude Desktop, Cursor, VS Code, etc.)

# Install globally
npm install -g axion-mcp-bridge

# Generate config for your MCP client
axion-mcp init

# Test connection
axion-mcp test

That's it! Copy the generated config to your MCP client and start using Earth Engine features.

📋 Supported MCP Clients

• ✅ Claude Desktop - Full support
• ✅ Cursor - Full support
• ✅ VS Code MCP - Full support
• ✅ Any MCP-compatible client - Generic config available

🎯 Features

• 🛰️ 50+ Satellite Datasets - Landsat, Sentinel, MODIS, and more
• 📊 Advanced Analysis - NDVI, water detection, urban analysis
• 🗺️ Interactive Maps - Beautiful web-based visualizations
• 🤖 AI-Powered - Natural language queries
• 🌐 Global Coverage - Any location on Earth

💻 CLI Commands

axion-mcp init

Interactive setup wizard for your MCP client

axion-mcp init
# Follow the prompts to set up your client

axion-mcp config

Generate configuration for your MCP client

# Show config for all clients
axion-mcp config

# Specific client
axion-mcp config --client claude

# Use local server
axion-mcp config --local

# Custom server
axion-mcp config --url https://your-server.com

axion-mcp start

Run the bridge in stdio mode (advanced)

axion-mcp start --debug

axion-mcp test

Test connection to server

axion-mcp test

🔧 Configuration Examples

Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

If installed globally via NPM:

# First, find where NPM installs global packages
npm root -g
# This will show something like: C:\Users\YourName\AppData\Roaming\npm\node_modules

Then use this configuration:

{
  "mcpServers": {
    "axion-mcp": {
      "command": "node",
      "args": ["C:\\Users\\YourName\\AppData\\Roaming\\npm\\node_modules\\axion-mcp-bridge\\bridge.js"]
    }
  }
}

If using local file:

{
  "mcpServers": {
    "axion-mcp": {
      "command": "node",
      "args": ["C:\\path\\to\\your\\bridge.js"]
    }
  }
}

Cursor

Add to your Cursor MCP config:

{
  "mcpServers": {
    "axion-earth-engine": {
      "command": "npx",
      "args": ["axion-mcp-bridge", "start"],
      "env": {}
    }
  }
}

Generic MCP Client

For any MCP-compatible client:

{
  "mcpServers": {
    "axion-earth-engine": {
      "command": "npx",
      "args": ["axion-mcp-bridge", "start"],
      "env": {
        "AXION_MCP_URL": "https://axion-mcp.onrender.com/sse"
      }
    }
  }
}

🌟 Usage Examples

Once configured, use natural language in your MCP client:

"Show vegetation health in California"
"Create a water map of the Nile River"
"Analyze urban growth in Tokyo"
"Monitor deforestation in the Amazon"
"Detect drought conditions in Australia"

🛠️ Advanced Usage

Programmatic API

import { connectToAxion } from 'axion-mcp-bridge';

// Connect to Axion server
const bridge = await connectToAxion({
  url: 'https://axion-mcp.onrender.com/sse',
  debug: true
});

// Bridge is now running

Custom Server

Run your own Axion server and connect:

# Start your local Axion server
cd axion-mcp
npm start

# Connect bridge to local server
axion-mcp start --url http://localhost:3000

🌐 Environment Variables

• AXION_MCP_URL - Server URL (default: https://axion-mcp.onrender.com/sse)
• AXION_DEBUG - Enable debug logging (true/false)

📊 What Can You Do?

Earth Observation

• Vegetation indices (NDVI, EVI, SAVI)
• Water body mapping
• Urban heat islands
• Deforestation tracking
• Crop health monitoring
• Flood extent mapping
• Wildfire detection
• Drought monitoring

Data Sources

• Sentinel-2 (10m resolution)
• Landsat 8/9 (30m resolution)
• MODIS (Daily global)
• VIIRS (375m resolution)
• Climate datasets
• Elevation models
• Land cover classifications

🆘 Troubleshooting

"Cannot connect to MCP server"

# Test the connection
axion-mcp test

# Check server status
curl https://axion-mcp.onrender.com/api/health

"Command not found"

# Reinstall globally
npm uninstall -g axion-mcp-bridge
npm install -g axion-mcp-bridge

"Bridge not starting"

# Run with debug mode
axion-mcp start --debug

🤝 Contributing

Contributions welcome! See the main repository.

📄 License

MIT © Axion Team

🔗 Links

• GitHub Repository
• NPM Package
• Documentation

Made with ❤️ by the Axion Team

Bringing satellite intelligence to every MCP client