SkyFi MCP Server

SkyFi MCP Server

A Model Context Protocol (MCP) server for integrating SkyFi satellite imagery capabilities with AI applications.

Overview

This MCP server provides AI applications with access to SkyFi's satellite imagery platform, enabling:

• Satellite Image Search & Ordering: Search and order high-resolution satellite imagery
• Archive Data Access: Access to historical satellite imagery archives
• Real-time Monitoring: Set up monitoring for specific areas of interest
• Multi-source Integration: Integration with OpenStreetMap and weather data

Quick Start

Prerequisites

• Python 3.11+
• SkyFi API credentials
• Optional: OpenWeatherMap API key for weather integration

Installation

# Clone the repository
git clone https://github.com/PSkinnerTech/SkyFi-MCP.git
cd SkyFi-MCP

# Install dependencies
pip install -e .

MCP Client Setup

Configure the SkyFi MCP server with your preferred AI development environment:

🖥️ Claude Desktop

Add to your configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "skyfi": {
      "command": "/path/to/your/project/venv/bin/python",
      "args": ["-m", "mcp_skyfi"],
      "env": {
        "SKYFI_API_KEY": "your-email@example.com:your-api-key-hash",
        "SKYFI_URL": "https://app.skyfi.com/platform-api/pricing"
      },
      "cwd": "/path/to/your/project"
    }
  }
}

⚡ Cursor AI

1. Install the MCP extension in Cursor
2. Add server configuration to your Cursor settings (Cmd/Ctrl + , → Extensions → MCP):

{
  "mcp.servers": {
    "skyfi": {
      "command": "/path/to/your/project/venv/bin/python",
      "args": ["-m", "mcp_skyfi"],
      "cwd": "/path/to/your/project",
      "env": {
        "SKYFI_API_KEY": "your-email@example.com:your-api-key-hash",
        "SKYFI_URL": "https://app.skyfi.com/platform-api/pricing"
      }
    }
  }
}

3. Alternative: Use .cursorrules file in your project root:

{
  "mcp_servers": {
    "skyfi": {
      "command": "python",
      "args": ["-m", "mcp_skyfi"],
      "env": {
        "SKYFI_API_KEY": "your-email@example.com:your-api-key-hash",
        "SKYFI_URL": "https://app.skyfi.com/platform-api/pricing"
      }
    }
  }
}

🏄 Windsurf (Codeium)

1. Open Windsurf Settings (Ctrl/Cmd + ,)
2. Navigate to Extensions → MCP Servers
3. Add New Server with these settings:

{
  "name": "skyfi",
  "command": "/path/to/your/project/venv/bin/python",
  "args": ["-m", "mcp_skyfi"],
  "working_directory": "/path/to/your/project",
  "environment": {
    "SKYFI_API_KEY": "your-email@example.com:your-api-key-hash",
    "SKYFI_URL": "https://app.skyfi.com/platform-api/pricing"
  }
}

Alternative: Project-level configuration (.windsurf/mcp.json):

{
  "servers": {
    "skyfi": {
      "command": "python",
      "args": ["-m", "mcp_skyfi"],
      "env": {
        "SKYFI_API_KEY": "your-email@example.com:your-api-key-hash",
        "SKYFI_URL": "https://app.skyfi.com/platform-api/pricing"
      }
    }
  }
}

📝 VSCode (with MCP Extension)

1. Install the MCP Extension from VSCode Marketplace
2. Add to VSCode settings (Ctrl/Cmd + , → Search "mcp"):

{
  "mcp.servers": {
    "skyfi": {
      "command": "/path/to/your/project/venv/bin/python",
      "args": ["-m", "mcp_skyfi"],
      "cwd": "/path/to/your/project",
      "env": {
        "SKYFI_API_KEY": "your-email@example.com:your-api-key-hash",
        "SKYFI_URL": "https://app.skyfi.com/platform-api/pricing"
      }
    }
  }
}

3. Alternative: Workspace settings (.vscode/settings.json):

{
  "mcp.servers": {
    "skyfi": {
      "command": "python",
      "args": ["-m", "mcp_skyfi"],
      "env": {
        "SKYFI_API_KEY": "your-email@example.com:your-api-key-hash",
        "SKYFI_URL": "https://app.skyfi.com/platform-api/pricing"
      }
    }
  }
}

🔧 Configuration Notes

🚨 Important Path Requirements:

• Full Python Path: Use absolute path to your Python executable (find with which python or where python)
• Working Directory: Must point to the project root where mcp_skyfi module is located
• API Key Format: Must be email:hash format from your SkyFi account

🔍 Finding Your Python Path:

# On macOS/Linux
which python
# Or for virtual environments
which python3

# On Windows
where python
# Or
python -c "import sys; print(sys.executable)"

📦 Virtual Environment Paths:

• Conda: ~/miniconda3/envs/your-env/bin/python
• venv: ./venv/bin/python (macOS/Linux) or .\venv\Scripts\python.exe (Windows)
• Poetry: ~/.cache/pypoetry/virtualenvs/your-project-*/bin/python

🧪 Testing Your Setup

After configuration, test with any of these commands in your AI assistant:

Use the osm_f