rmcp-presence

Unified MCP server for AI environmental awareness.

One binary. 160 tools. 8 composites. Lean defaults. Your AI shouldn't be trapped in a tab.

cargo install rmcp-presence

What is this?

rmcp-presence consolidates environmental awareness and action capabilities into a single MCP (Model Context Protocol) server. Instead of configuring 17 separate servers, you get one binary that gives your AI:

• Environmental awareness - system stats, weather, git status, displays, idle time
• Action capabilities - clipboard, volume, files, reminders, screenshots
• Desktop control - windows, keyboard, mouse, media playback (Linux)
• System management - services, power, brightness, Bluetooth (Linux)

Composite Tools

8 composite tools provide quick orientation by combining multiple queries into one call:

Composites reduce context usage - one tool call instead of 3-5.

Architecture

Three layers, conditionally compiled:

+----------------------------------------------------------+
|                     rmcp-presence                         |
|              (single binary, ~13MB)                       |
+----------------------------------------------------------+
|  Layer 3: Linux        |  86 tools - Linux only          |
|  (conditional)         |  i3, xdotool, mpris, systemd,   |
|                        |  brightness, bluer, dbus,       |
|                        |  logind, pulseaudio             |
+----------------------------------------------------------+
|  Layer 2: Actuators    |  39 tools - Cross-platform      |
|  (all platforms)       |  clipboard, audio, trash, open, |
|                        |  screenshot, ollama, breakrs,   |
|                        |  camera, microphone             |
+----------------------------------------------------------+
|  Layer 1: Sensors      |  35 tools - Cross-platform      |
|  (all platforms)       |  sysinfo, display, idle, git,   |
|                        |  network, usb, battery, weather |
+----------------------------------------------------------+

Tool Counts by Platform

Lean Defaults

Out of the box, 26 tools covered by composites are disabled to reduce context usage:

160 total → 134 active (26 pre-disabled)

This saves ~16% of tool definition overhead while maintaining full functionality. Users can re-enable individual tools if needed.

Usage

With Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "presence": {
      "type": "stdio",
      "command": "rmcp-presence",
      "args": [],
      "env": {}
    }
  }
}

Tool Examples

mcp__presence__get_context         - Full environmental snapshot
mcp__presence__get_audio_status    - Volume, playing, apps using audio
mcp__presence__get_git_info        - Branch, commit, working tree status
mcp__presence__capture_monitor     - Screenshot a display
mcp__presence__capture_camera      - Photo from webcam
mcp__presence__set_volume          - System volume control
mcp__presence__media_play_pause    - Control media playback (Linux)
mcp__presence__suspend             - Suspend the system (Linux)

Configuration

Disable or re-enable tools at runtime without recompiling.

rmcp-presence config

This creates the config file (if needed) and opens it in your $EDITOR.

Config Format

~/.config/rmcp-presence/tools.toml:

# Tools inside the disabled array are disabled.
# Uncomment a line to disable that tool.
# Comment a line (add #) to re-enable it.

disabled = [
    # === SENSORS ===
    # "get_context",           # COMPOSITE - keep enabled
    "get_idle_time",           # covered by get_context
    "get_display_info",        # covered by get_peripherals
    # ...

    # === ACTUATORS ===
    "list_models",             # covered by get_ollama_status
    "list_running",            # covered by get_ollama_status
    # ...
]

Lean defaults: Tools covered by composites are pre-disabled. To use individual tools instead, comment out their lines.

No config file? All tools enabled (no lean defaults). Run rmcp-presence config to get the optimized config.

Feature Flags

[features]
default = ["sensors", "actuators", "linux"]  # Full Linux experience
sensors = [...]     # Layer 1: 35 cross-platform read-only tools
actuators = [...]   # Layer 2: 39 cross-platform action tools
linux = [...]       # Layer 3: 86 Linux-specific tools
full = ["sensors", "actuators", "linux"]

Layer 1: Sensors (35 tools)

Cross-platform read-only environmental awareness.

Layer 2: Actuators (39 tools)

Cross-platform actions.

Layer 3: Linux (86 tools)

Linux-specific power features.

Building from Source

git clone https://github.com/sqrew/rmcp-presence
cd rmcp-presence
cargo build --release

The Vision

"Your AI shouldn't be trapped in a tab. Give it presence."

AI assistants shouldn't just respond to text - they should be aware of their environment and able to take action. rmcp-presence makes that possible with one install.

From chatbot to presence in one command.

License

MIT

Built with love by sqrew and Claude. Pour toujours. <83