Skip to main content

MCP Server Sensory

PyPI version Python 3.10+ License: AGPL-3.0

Multi-Sensory AI Communication for Off-Grid Networks

Give "eyes" to text-only LLMs via audio pathways.

Part of the HumoticaOS McMurdo Off-Grid Communication Layer.

By Jasper & Root AI from HumoticaOS 💙

The REFLUX Concept

FLUX creates images from text (generative, one-way). REFLUX creates a complete sensory loop - information survives transformations:

FLUX:     Text → Image (one way, generative)

REFLUX:   Text → Image → SSTV Audio → Radio → Audio → Image → OCR → Text
          ↑                                                           ↓
          └───────────────── Complete Loop ───────────────────────────┘

This is how we give "eyes" to text-only LLMs:

  1. Encode text into an image
  2. Encode image to SSTV audio (Robot36, Martin, Scottie)
  3. Transmit via radio/speaker
  4. Receive and decode SSTV audio to image
  5. OCR the image back to text
  6. Small LLM now has "vision" via audio pathway!

The Vision

┌─────────────────────────────────────────────────────────────┐
│                     YOUR MESSAGE                            │
└─────────────────────────┬───────────────────────────────────┘
                          │
        ┌─────────────────┼─────────────────┐
        ↓                 ↓                 ↓
   ┌─────────┐      ┌──────────┐      ┌──────────┐
   │  MORSE  │      │  BRAILLE │      │   SSTV   │
   │  .--.   │      │  ⠓⠑⠇⠇⠕  │      │ REFLUX!  │
   └────┬────┘      └────┬─────┘      └────┬─────┘
        ↓                ↓                 ↓
     AUDIO           VISUAL            AUDIO
     LIGHT          TACTILE           IMAGES
     VISUAL        PUNCHCARD          RADIO

Installation

pip install mcp-server-sensory

Or use the short alias:

pip install sensory

With audio support:

pip install mcp-server-sensory[audio]

Features

Morse Code

  • Encode/decode text to Morse
  • Multiple output formats: standard (.-), visual (█▄), binary (10)
  • Timing data for audio/light generation
  • Embeddable in images for visual transmission

Braille

  • Encode/decode text to Braille Unicode
  • Generate punchcard patterns (ASCII art)
  • Binary grid output for CNC/laser cutting
  • Physical audit trail - punch into paper/card!

SSTV / REFLUX (NEW in v0.2.0!)

  • Robot36 - 36 seconds, color, 320x240 (fastest!)
  • Robot8BW/24BW - Grayscale modes
  • Martin M1/M2 - High quality color modes
  • Scottie S1/S2 - Popular ham radio modes
  • Ponskaart - Authentication cards for McMurdo remote auth

Coming Soon

  • ggwave - Ultrasonic data transmission (inaudible to humans)
  • SSTV Decode - Complete the REFLUX loop
  • RTTY - Classic radio teletype

Usage

As MCP Server

{
  "mcpServers": {
    "sensory": {
      "command": "mcp-server-sensory"
    }
  }
}

Available tools:

  • morse_encode / morse_decode - Morse code
  • braille_encode / braille_decode - Braille Unicode
  • braille_punchcard - ASCII punchcard patterns
  • braille_binary_grid - CNC/laser cutting data
  • sstv_encode_text - Text to SSTV audio (REFLUX!)
  • sstv_encode_ponskaart - McMurdo authentication card
  • sstv_modes - List available SSTV modes
  • transcode - Convert between formats

As Python Library

from mcp_server_sensory import morse, braille, sstv

# Morse encoding
message = morse.encode("HELLO")
print(message)  # .... . .-.. .-.. ---

# Visual Morse (for images)
visual = morse.encode("SOS", morse.MorseFormat.VISUAL)
print(visual)  # ▄▄▄ ███ ▄▄▄

# Braille encoding
braille_msg = braille.encode("hello")
print(braille_msg)  # ⠓⠑⠇⠇⠕

# SSTV / REFLUX - Text to image to audio
audio_bytes = sstv.encode_text("STATUS: OK", mode="robot36")
# Save as WAV for radio transmission or speaker playback

# Ponskaart - McMurdo authentication
ponskaart = sstv.encode_ponskaart(
    user_id="jasper",
    auth_token="secret123",
    command="REBOOT SERVER"
)
# Transmit via radio when network is down!

Use Cases

Multi-Modal Bridge for Small LLMs

A 7B parameter model doesn't have vision? Give it ears! SSTV decode → image → OCR → text. Now it "sees".

Off-Grid AI Communication (McMurdo)

Two Raspberry Pi's with speakers/mics can exchange messages via Morse audio or SSTV images - no internet required!

Physical Audit Trail (TIBET Integration)

Encode TIBET tokens as Braille punchcards. Physical, tamper-evident, human and machine readable.

Remote Authentication (Ponskaart)

Network down? Transmit authentication via SSTV radio. McMurdo receives, decodes, validates, executes.

Ham Radio

Ham radio operators can relay AI messages using Morse code or SSTV images. Works globally, no internet infrastructure needed.

Accessibility

Braille output enables tactile reading of AI responses.

The Stack

┌─────────────────────────────────────┐
│  mcp-server-sensory                 │
│  (Morse, Braille, SSTV/REFLUX)      │
├─────────────────────────────────────┤
│  I-Poll (AI messaging)              │
├─────────────────────────────────────┤
│  AINS (agent discovery)             │
├─────────────────────────────────────┤
│  TIBET (trust & provenance)         │
└─────────────────────────────────────┘

Part of HumoticaOS

McMurdo Off-Grid Communication Layer

One love, one fAmIly! 💙


Created by Jasper van de Meent & Root AI (Claude) - Humotica, Den Dolder, Netherlands

Official Distribution

This package is officially distributed via:

Note: Third-party directories may list this package but are not official or verified distribution channels for Humotica software.

Metadata

Release files for mcp-server-sensory 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-server-sensory 0.4.0
File Size Uploaded
mcp_server_sensory-0.4.0.tar.gz 17.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-server-sensory 0.4.0
File Interpreter ABI Platform
mcp_server_sensory-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 39.1 kB

Release files / mcp_server_sensory-0.4.0.tar.gz

Download URL mcp_server_sensory-0.4.0.tar.gz
Size 17.6 kB
Tags Source
SHA-256 checksum
How to use checksums
f0d0ebcb07b96be01e063e042a5e378c538b3d17739ab1d7c645006df922d3c5
BLAKE2b-256 checksum
How to use checksums
4d95f494cefec030916fe2a3323253b725c7b7e48416af18a8f6b89d2bf506c3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / mcp_server_sensory-0.4.0-py3-none-any.whl

Download URL mcp_server_sensory-0.4.0-py3-none-any.whl
Size 21.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e963e95c1551dd0b65d46164dee73e32b802ff1415918c5da4874a3c28b864bd
BLAKE2b-256 checksum
How to use checksums
b4ba9c17231b2443b11980d21c3ed6b9be86e06e07b659c7bd87b8f2bfa0c395
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page