MQTTSPY
cognis-digital/mqttspy
Mapeamento de segurança MQTT: tópicos, escritas não autorizadas e vazamento de dados
Ver no GitHubFerramenta de segurança que mapeia passivamente brokers MQTT, enumerando tópicos, detectando escritas não autorizadas, identificando PII e segredos em payloads, e gerando relatórios de risco priorizados. Funciona como MCP server nativo, CI-ready e auto-hospedável.
Instalação
npx convez-ai cognis-digital/mqttspy1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Auditoria de segurança em brokers MQTT IoT/OT
- Detecção de exposição de credenciais e PII em tópicos MQTT
- Integração em pipeline CI/CD para gating de segurança
- Mapeamento e classificação de risco em infraestruturas de dispositivos embarcados
Veredito

Ferramenta especializada, bem-construída e CI-native para auditoria de MQTT em tempo real. Ideal para DevSecOps preocupados com IoT/OT; seu escopo restrito (MQTT only) é força, não fraqueza — faz uma coisa e faz bem, com reporting automático e MCP-ready.
README
A tradução para o português deste README ainda está na fila.
MQTTSPY
Passively map an MQTT broker: enumerate topics, detect unauthenticated writes, spot PII/secrets in payloads, and emit a risk report.
IoT / OT / Embedded — firmware, buses, and device security.
pip install cognis-mqttspy
mqttspy scan . # → prioritized findings in seconds
Contents
- Why mqttspy? · Features · Quick start · Example · Architecture · AI stack · How it compares · Integrations · Install anywhere · Related · Contributing
Why mqttspy?
Shodan-bait — 'I found 40k open brokers leaking door-lock state' is evergreen viral content; the tool turns that into a repeatable, redactable scan.
mqttspy is single-purpose, scriptable, and self-hostable: point it at a target, get prioritized results in the format your workflow already speaks (table · JSON · SARIF), gate CI on it, and let agents drive it over MCP.
Features
- ✅ Parse Capture
- ✅ Enumerate Topics
- ✅ Detect Unauth Writes
- ✅ Detect Secrets
- ✅ Scan
- ✅ Runs on Linux/macOS/Windows · Docker · devcontainer
- ✅ Ports in Python, JavaScript, Go, and Rust (
ports/)
Quick start
pip install cognis-mqttspy
mqttspy --version
mqttspy scan . # scan current project
mqttspy scan . --format json # machine-readable
mqttspy scan . --fail-on high # CI gate (non-zero exit)
Example
$ mqttspy scan .
[HIGH ] MQT-001 example finding (./src/app.py)
[MEDIUM ] MQT-002 another signal (./config.yaml)
2 findings · risk score 5 · 38ms
Architecture
flowchart LR
A[Input: file / dir / API] --> B[Collectors]
B --> C[Rules / Analyzers]
C --> D[Scorer]
D --> E{Reporters}
E --> F[Table]
E --> G[JSON / SARIF]
E --> H[MCP tool -. drives .-> AI agents]
Use it from any AI stack
mqttspy is interoperable with every popular way of using AI:
- MCP server —
mqttspy mcp(Claude Desktop, Cursor, Cognis.Studio, uncensored-fleet) - OpenAI-compatible / JSON — pipe
mqttspy scan . --format jsoninto any agent or LLM - LangChain · CrewAI · AutoGen · LlamaIndex — wrap the CLI/JSON as a tool in one line
- CI / scripts — exit codes + SARIF for non-AI pipelines
How it compares
| Cognis mqttspy | mqtt-explorer + nuclei | |
|---|---|---|
| Self-hostable, no account | ✅ | varies |
| Single command, zero config | ✅ | ⚠️ |
| JSON + SARIF for CI | ✅ | varies |
| MCP-native (AI agents) | ✅ | ❌ |
| Polyglot ports (JS/Go/Rust) | ✅ | ❌ |
| Open license | ✅ COCL | varies |
Built in the spirit of mqtt-explorer + nuclei, re-framed the Cognis way. Missing a credit? Open a PR.
Integrations
Pipes into your stack: SARIF for code-scanning, JSON for anything, an MCP server (mqttspy mcp) for AI agents, and a webhook forwarder for SIEM/Slack/Jira. See docs/INTEGRATIONS.md.
Install — every way, every platform
pip install "git+https://github.com/cognis-digital/mqttspy.git" # pip (works today)
pipx install "git+https://github.com/cognis-digital/mqttspy.git" # isolated CLI
uv tool install "git+https://github.com/cognis-digital/mqttspy.git" # uv
pip install cognis-mqttspy # PyPI (when published)
docker run --rm ghcr.io/cognis-digital/mqttspy:latest --help # Docker
brew install cognis-digital/tap/mqttspy # Homebrew tap
curl -fsSL https://raw.githubusercontent.com/cognis-digital/mqttspy/main/install.sh | sh
| Linux | macOS | Windows | Docker | Cloud |
|---|---|---|---|---|
scripts/setup-linux.sh | scripts/setup-macos.sh | scripts/setup-windows.ps1 | docker run ghcr.io/cognis-digital/mqttspy | DEPLOY.md (AWS/Azure/GCP/k8s) |
Related Cognis tools
fwxray— Diff two firmware images and surface exactly what changed: new binaries, flipped config flags, added certs, and shifted entropy regions.canzap— Replay, fuzz, and assert on CAN bus traffic from a .pcap or SocketCAN interface with a tiny YAML DSL.sbomb— Generate a CycloneDX SBOM directly from an unpacked firmware root filesystem and flag components with known CVEs and EOL kernels.uefiscan— Audit UEFI firmware dumps for missing Secure Boot keys, unsigned modules, S3 boot-script vulns, and known SMM threats.modpot— Spin up a high-interaction Modbus/DNP3 ICS honeypot that logs attacker register reads/writes as structured JSON.keyhunt— Scan firmware blobs and filesystem dumps for hardcoded private keys, API tokens, default creds, and weak RSA/ECC material.
Explore the suite → 🗂️ all 170+ tools · ⭐ awesome-cognis · 🔗 cognis-sources · 🤖 uncensored-fleet · 🧠 hermes
Contributing
PRs, new rules, and demo scenarios are welcome under the collaboration-pull model — see CONTRIBUTING.md and SECURITY.md.
⭐ If
mqttspysaved you time, star it — it genuinely helps others find it.
License
Source-available under the Cognis Open Collaboration License (COCL) v1.0 — free for personal, internal-evaluation, research, and educational use; commercial / production use requires a license (licensing@cognis.digital). See LICENSE.