D-Bus architecture showing session and system services connected through the bus

mcdbus

Bridge Linux IPC into the Model Context Protocol. Discover and interact with session and system D-Bus services through introspection-first discovery.

Get Started View on PyPI

# Install and register with Claude Code in one shot
claude mcp add mcdbus -- uvx mcdbus

No configuration files, no service definitions, no API keys. The server discovers what is available on your D-Bus at runtime.

Discovery

list_services, introspect, and list_objects map out your bus. Start from nothing and build a complete picture of any service — its object tree, interfaces, methods, properties, and signals.

Interaction

call_method, get_property, set_property, and get_all_properties let Claude read state and invoke operations on any D-Bus service. System bus calls and property mutations require confirmation.

Shortcuts

Pre-wired tools for common operations: desktop notifications, MPRIS media player control, systemd unit listing, NetworkManager status, UPower battery state, bluez Bluetooth devices, and KDE KWin window listing.

Installation pip, uvx, or from source — plus Claude Code registration.

First Steps Walk through your first D-Bus exploration with mcdbus.

Tool Reference Full documentation for all 16 tools, 3 resources, and 2 prompts.

Built on D-Bus, the inter-process communication system at the heart of every Linux desktop. Source on GitLab.