# aletheiavox/signal_bridge architecture

> Architecture diagram of the GitHub repository aletheiavox/signal_bridge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aletheiavox/signal_bridge
- Repository: https://github.com/aletheiavox/signal_bridge

## Overview

Signal Bridge is a local MCP server that exposes Claude tool calls for controlling intimate devices through Intiface Central and the Buttplug protocol. The main workflow is Claude tool request → connection and safety checks → device command or managed pattern → hardware. The sampled source shows the controller, safety governor, device-profile loading, and command/pattern behavior; the README documents the Claude and Intiface integrations. Other README-listed tools are grouped rather than mapped individually because their implementations were not sampled.

Main entry points: [`signal_bridge_mcp.py`](https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py) (Device controller), [`devices.json`](https://github.com/aletheiavox/signal_bridge/blob/main/devices.json) (Device registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["MCP interface"]
  node_mcp["MCP server"]
  node_tools["Control tools"]
end

subgraph group_control["Device control"]
  node_controller["Device controller"]
  node_patterns["Patterns and timers"]
end

subgraph group_safety["Safety and profiles"]
  node_profiles["Device profiles"]
  node_registry["Device registry<br/>[devices.json]"]
  node_governor["Safety governor"]
end

node_claude(("Claude Desktop"))
node_intiface["Intiface Central"]
node_hardware{{"Connected devices"}}

node_claude -->|"invokes tools"| node_mcp
node_mcp -->|"exposes"| node_tools
node_tools -->|"checks safety"| node_governor
node_tools -->|"sends commands"| node_controller
node_tools -->|"starts patterns"| node_patterns
node_registry -->|"loads profiles"| node_profiles
node_controller -.->|"uses profiles"| node_profiles
node_controller -->|"connects and scans"| node_intiface
node_controller -->|"sends output"| node_hardware
node_patterns -->|"sends pattern output"| node_controller

click node_mcp "https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py"
click node_tools "https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py"
click node_profiles "https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py"
click node_registry "https://github.com/aletheiavox/signal_bridge/blob/main/devices.json"
click node_governor "https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py"
click node_controller "https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py"
click node_patterns "https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp,node_tools toneBlue
class node_controller,node_patterns toneAmber
class node_profiles,node_registry,node_governor toneMint
class node_claude,node_intiface,node_hardware toneIndigo
```

## Components

### MCP interface

- [MCP server](https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py): `signal_bridge_mcp.py`
- [Control tools](https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py): `signal_bridge_mcp.py`

### Device control

- [Device controller](https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py): `signal_bridge_mcp.py`
- [Patterns and timers](https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py): `signal_bridge_mcp.py`

### Safety and profiles

- [Device profiles](https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py): `signal_bridge_mcp.py`
- [Device registry](https://github.com/aletheiavox/signal_bridge/blob/main/devices.json): `devices.json`
- [Safety governor](https://github.com/aletheiavox/signal_bridge/blob/main/signal_bridge_mcp.py): `signal_bridge_mcp.py`

### Other components

- **Claude Desktop**
- **Intiface Central**
- **Connected devices**

## Connections

- Claude Desktop → MCP server: invokes tools (evidence: `README.md`)
- MCP server → Control tools: exposes (evidence: `README.md`)
- Control tools → Safety governor: checks safety (evidence: `signal_bridge_mcp.py`)
- Control tools → Device controller: sends commands (evidence: `signal_bridge_mcp.py`)
- Control tools → Patterns and timers: starts patterns (evidence: `signal_bridge_mcp.py`)
- Device registry → Device profiles: loads profiles (evidence: `signal_bridge_mcp.py`)
- Device controller → Device profiles: uses profiles (evidence: `signal_bridge_mcp.py`)
- Device controller → Intiface Central: connects and scans (evidence: `README.md`)
- Device controller → Connected devices: sends output (evidence: `signal_bridge_mcp.py`)
- Patterns and timers → Device controller: sends pattern output (evidence: `signal_bridge_mcp.py`)
