asterisk-mcp

MCP server for Asterisk in Docker on the ship VM (shipPortal). SSH + docker exec + asterisk -rx.

Quick start

cd ~/Projects/asterisk-mcp
python3 -m venv .venv && .venv/bin/pip install -e .

Connect

asterisk_connect(
  ssh_host="10.20.30.222",
  ssh_key_path="/Users/nearxos/.ssh/id_ed25519",
  container="asterisk",
  name="golden-asterisk"
)
asterisk_test_connection()
asterisk_pjsip_show_endpoints()

Tools

Tool	Description
asterisk_connect / asterisk_use_target	Persisted targets
asterisk_cli	Arbitrary asterisk -rx
asterisk_pjsip_show_endpoints	Registration state
asterisk_core_show_channels	Active calls
asterisk_get_logs	Tail /var/log/asterisk/full
asterisk_read_config	Read file in container
asterisk_module_reload	Reload module (writes)

License

MIT