Cosmic Ears MCP

Gives an assistant tools to find public satellite radio observations, play short excerpts, measure audio, and draw spectrograms with provenance.

What you can do

A local Python server exposing eleven tools for exploring real radio recordings. It searches SatNOGS observation metadata, fetches up to 90 seconds of permitted audio as mono 16 kHz WAV, and computes peak/RMS, dominant frequency and spectral centroid. It renders Hann-window STFT spectrogram PNGs, compares recordings, exports Markdown evidence reports, and runs a fully offline synthetic demo. A one-call explore tool bundles search, excerpt, plot, measurements and credits.

When to use it

Use it when you want an assistant to investigate genuine radio observations conversationally: finding satellite passes with audio, listening to excerpts, interpreting spectrograms, or producing credited evidence reports. It also suits teaching about radio signals through the labeled synthetic demo. It is not a live telescope, an astrophysical classifier, or an alien-signal detector.

Requirements

Runs locally over stdio; the manifest declares no authentication, environment variables or headers. Installation uses uv/uvx and needs internet the first time; the demo then runs offline. Reports need a directory approved at startup via --report-dir or COSMIC_EARS_REPORT_DIR, and local audio outside managed artifacts must be opted in with --allow-file. No radio, account or paid service is required.