skyspark-mcp

MCP server for SkySpark — connect AI assistants to your building automation data.

Evaluate Axon expressions, read/write records, manage functions, and explore your SkySpark projects through the Model Context Protocol.

Features

• 21 tools for comprehensive SkySpark interaction

• SCRAM, token, or no-auth — works with any network setup (including Tailscale)

• Multi-project — target different projects from the same server

• Base64-safe commits — avoids Axon ${} string interpolation issues

• Production-tested — used daily for building analytics dashboards

Quick Start

pip install skyspark-mcp

Create a .env file (see .env.example):

SKYSPARK_HOST=192.168.1.100
SKYSPARK_PORT=8080
SKYSPARK_PROJECT=demo
SKYSPARK_AUTH=scram
SKYSPARK_USERNAME=su
SKYSPARK_PASSWORD=your-password

Run the server:

# SSE transport (default, port 8765)
skyspark-mcp

# stdio transport (for direct MCP client integration)
skyspark-mcp --stdio

Tools

Core

CRUD

Functions

Content (base64-safe)

Discovery

Authentication

SCRAM (default)

Standard SkySpark authentication. Set SKYSPARK_USERNAME and SKYSPARK_PASSWORD.

No Auth

For trusted networks (Tailscale, VPN, localhost). Set SKYSPARK_AUTH=none. The server strips auth headers automatically.

Token

Pre-shared auth token. Set SKYSPARK_AUTH=token and SKYSPARK_PASSWORD=your-token.

Multi-Project

Every tool accepts an optional project and server parameter:

ss_eval(expr="readAll(site)", project="other_project")
ss_read(filter_expr="site", server="http://other-server:8080", project="demo")

Clients are pooled per server+project combination.

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "skyspark": {
      "command": "skyspark-mcp",
      "args": ["--stdio"],
      "env": {
        "SKYSPARK_HOST": "192.168.1.100",
        "SKYSPARK_PORT": "8080",
        "SKYSPARK_PROJECT": "demo",
        "SKYSPARK_AUTH": "scram",
        "SKYSPARK_USERNAME": "su",
        "SKYSPARK_PASSWORD": "your-password"
      }
    }
  }
}

Usage with mcporter

# SSE
npx mcporter call --allow-http 'http://localhost:8765/mcp.ss_eval(expr: "readAll(site)")'

# stdio
npx mcporter call --stdio "skyspark-mcp --stdio" 'ss_eval(expr: "1 + 1")'

Dependencies

• phable — Python Haystack client

• FastMCP — MCP server framework

License

MIT — built by Pip 🌱