SkyFi MCP Server

SkyFi Model Context Protocol (MCP) server for AI agent integration with geospatial data services.

Overview

SkyFi MCP enables AI agents to seamlessly interact with SkyFi's geospatial data services through a comprehensive RESTful API with Server-Sent Events (SSE) support. The server provides:

• Order Management: Create, track, and manage geospatial data orders

• Data Search: Iterative search and exploration of geospatial data catalogs

• Pricing & Feasibility: Check order feasibility and get pricing estimates

• Monitoring: Set up Area of Interest (AOI) monitoring with webhook notifications

• Framework Integration: Native support for ADK, LangChain, and AI SDK

Quick Start

Prerequisites

• Node.js >= 18.0.0

• Docker and Docker Compose

• PostgreSQL 15+ (or use Docker Compose)

• Redis 7+ (or use Docker Compose)

Installation

1. Clone the repository:

2. Install dependencies:

3. Copy environment file:

4. Update .env with your configuration:

   • Set SKYFI_API_KEY with your SkyFi API key

   • Configure database and Redis URLs

   • Set security keys (JWT_SECRET, API_KEY_ENCRYPTION_KEY)

5. Start services with Docker Compose:

6. Run database migrations (when available):

7. Start the development server:

The server will be available at http://localhost:3000

Development

Scripts

• npm run dev - Start development server with hot reload

• npm run build - Build TypeScript to JavaScript

• npm start - Start production server

• npm test - Run tests

• npm run test:watch - Run tests in watch mode

• npm run test:coverage - Generate test coverage report

• npm run lint - Run ESLint

• npm run lint:fix - Fix ESLint errors

• npm run format - Format code with Prettier

• npm run type-check - Type check without building

Project Structure

API Documentation

API documentation is available at /docs/api when the server is running.

Base URL

• Development: http://localhost:3000/v1

• Production: https://api.skyfi-mcp.com/v1

Authentication

All API requests require an API key in the Authorization header:

Example Request

Testing

Run the test suite:

Run tests with coverage:

Docker

Build Image

Run Container

Docker Compose

Start all services:

Stop all services:

View logs:

Environment Variables

See .env.example for all available environment variables.

Key variables:

• SKYFI_API_KEY - Your SkyFi API key (required)

• DATABASE_URL - PostgreSQL connection string

• REDIS_URL - Redis connection string

• JWT_SECRET - Secret for JWT tokens

• API_KEY_ENCRYPTION_KEY - Key for encrypting API keys

Framework Integration

ADK

See docs/integration/adk.md for ADK integration guide.

LangChain

See docs/integration/langchain.md for LangChain integration guide.

AI SDK

See docs/integration/ai-sdk.md for AI SDK integration guide.

Contributing

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

MIT License - see LICENSE file for details

Support

For support, please open an issue in the repository or contact support@skyfi.com

Status

🚧 In Development - This project is currently in active development. See the PRD and Architecture Documentation for more details.

Version: 1.0.0
Last Updated: January 2025