rust-debug-mcp
Provides tools for debugging and operating Rust Tauri applications over WebSocket, including app lifecycle management, core debugging, metrics inspection, UI automation, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rust-debug-mcp check connection to my Tauri app"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
rust-debug-mcp
A Model Context Protocol (MCP) server for debugging and operating Rust Tauri applications over WebSocket.
Table of Contents
Related MCP server: tauri-plugin-mcp
Overview
rust-debug-mcp bridges MCP clients and Tauri debug backends. It provides a single tool (tauri_debug_command) that routes commands to specialized handlers for app lifecycle operations, core debugging, metrics/task inspection, frontend actions, and UI automation.
It supports multiple target apps through configs/apps.json, including capability checks per app before command execution.
Features
Core Functionality
Multi-app registry support with per-app command capability gating
App lifecycle management (
start_app,kill_app)Core debug command forwarding through a typed WebSocket bridge
Response verbosity control (
conciseanddetailed)
Debugging & Inspection
Task/session/metrics commands for Commander-style backends
Frontend broadcast support for app-side actions
UI automation commands (
click,fill,select,type,press_key, snapshots, screenshots, wait/hover/scroll, console logs)
Reliability
Connection status checks and reconnect behavior in bridge manager
Request timeout handling for bridge calls
Ordered handler routing with clean command-to-handler resolution
Installation
Quick Setup
# Clone repository
git clone https://github.com/ruizrica/rust-debug-mcp.git
# Enter project
cd rust-debug-mcp
# Install dependencies
npm install
# Build
npm run buildInstalling in an MCP Client
Add to your MCP config (example):
{
"mcpServers": {
"tauri-debug": {
"command": "node",
"args": ["/absolute/path/to/rust-debug-mcp/dist/server.js"],
"env": {
"LOG_LEVEL": "info",
"TAURI_WS_URL": "ws://localhost:9002",
"COMMANDER_WS_URL": "ws://localhost:9002"
}
}
}
}For deeper setup and troubleshooting, see docs/RUNBOOK.md.
Usage
Starting the Server
npm run dev
# or
npm startThe server communicates over stdio and is intended to be launched by an MCP client.
Multi-App Configuration
configs/apps.json controls default app, app endpoints, and command capability sets:
{
"default": "commander",
"apps": {
"commander": {
"name": "Commander",
"wsUrl": "ws://localhost:9002",
"commands": ["all"]
},
"photon": {
"name": "Photon CLI",
"wsUrl": "ws://localhost:9847",
"commands": ["core", "ui_automation"]
}
}
}Tools API
The server exposes one MCP tool:
Tool | Description |
| Execute a debug command against a selected app ( |
Command Categories
App lifecycle:
start_app,kill_appCore:
test_connection,get_debug_mode,set_debug_mode,get_app_dir,get_logs,get_system_metrics,test_command,simple_testTask/session/metrics:
get_session_metrics,get_task_metrics,get_all_tasks,get_task,get_tasks_by_status,get_task_groups,list_windowsFrontend action:
broadcast_to_frontendUI automation:
click,fill,select,type,press_key,get_snapshot,take_screenshot,wait_for,hover,scroll,get_console_logs
For full payload details, see docs/COMMAND_REFERENCE.md.
Examples
Minimal Command
{
"command": "test_connection"
}Targeting a Specific App
{
"command": "get_debug_mode",
"app": "commander"
}UI Interaction
{
"command": "click",
"app": "photon",
"params": {
"uid": "e5"
}
}Development
Project Structure
rust-debug-mcp/
├── src/
│ ├── server.ts # MCP server entry point
│ ├── bridge-manager.ts # WebSocket bridge and manager
│ ├── app-registry.ts # Multi-app registry and capability checks
│ ├── handlers/ # Command handlers and router
│ ├── response-formatter.ts # Concise/detailed output formatter
│ └── types.ts # Type definitions
├── configs/
│ └── apps.json
├── docs/
├── tests/
├── package.json
└── tsconfig.jsonBuild
npm run buildTypecheck
npm run typecheckTesting
npm test
npm run test:unit
npm run test:integrationContributing
Contributions are welcome.
Fork the repository
Create a feature branch
Make and test your changes
Open a pull request
License
MIT
Built with TypeScript, Rust, Tauri, and MCP.
Available Tools
1 tooltauri_debug_commandA
Debug and inspect Tauri applications via WebSocket.
MULTI-APP SUPPORT: This tool can connect to any Tauri app with a debug WebSocket endpoint.
Available apps: commander, photon
Default app: commander
Use "app" parameter to specify which app to connect to
QUICK REFERENCE:
Lifecycle: start_app, kill_app
Health: test_connection, get_debug_mode
Tasks: get_task, get_tasks_by_status, get_task_metrics, get_all_tasks (Commander only)
Sessions: get_session_metrics, list_windows (Commander only)
System: get_system_metrics, get_app_dir, get_logs
Actions: broadcast_to_frontend, set_debug_mode (Commander only)
UI Automation: click, fill, select, type, press_key, get_snapshot, take_screenshot, wait_for, hover, scroll, get_console_logs
FILTERING TASKS (avoid loading all tasks): { "command": "get_task", "params": { "task_id": 123 } } { "command": "get_tasks_by_status", "params": { "status": "working" } } { "command": "get_all_tasks", "params": { "status": "pending", "limit": 20 } } { "command": "get_all_tasks", "params": { "recent_only": true } }
RESPONSE FORMAT: Add response_format: "concise" (default) or "detailed" to control verbosity.
concise: Truncates arrays to 20 items, includes metadata about truncation
detailed: Returns full data without truncation
APP LIFECYCLE COMMANDS:
"start_app": Start a Tauri application (optional: path, command, args, env, timeout, waitForConnection)
"kill_app": Kill a running Tauri application (optional: force, timeout)
CORE COMMANDS (all apps):
"test_connection": Check Tauri bridge connectivity
"get_debug_mode": Get current debug mode status
"set_debug_mode": Enable/disable debug mode (requires enabled: boolean)
"get_app_dir": Get application directory paths
"get_logs": Get recent application logs
"get_system_metrics": Get system resource metrics
"test_command": Test command execution (requires command: string)
"simple_test": Run a simple test command
COMMANDER-SPECIFIC COMMANDS:
"get_task": Get single task by ID (requires task_id: number)
"get_tasks_by_status": Get tasks filtered by status (requires status: string)
"get_all_tasks": Get tasks with optional filtering (status?, limit?, recent_only?)
"get_task_metrics": Get task count breakdown by status
"get_task_groups": Get task groups/initiatives with progress
"get_session_metrics": Get active sessions list
"list_windows": List connected WebSocket clients
"broadcast_to_frontend": Send message to frontend (requires action, payload)
UI AUTOMATION COMMANDS:
"click": Click element (requires uid: string)
"fill": Clear and fill input element (requires uid: string, value: string)
"select": Select dropdown option (requires uid: string, value: string)
"type": Type text into element (requires uid: string, text: string)
"press_key": Press keyboard key or combination (requires key: string)
"get_snapshot": Get accessibility tree snapshot (returns interactive elements with refs)
"take_screenshot": Take page screenshot (optional: full_page: boolean, path: string)
"wait_for": Wait for text or element (requires text_or_selector: string, timeout?: number)
"hover": Hover over element (requires uid: string)
"scroll": Scroll page or element (requires direction: string, amount?: number)
"get_console_logs": Get browser/frontend console messages (optional: types[], limit, includePreservedLogs)
EXAMPLES: { "command": "start_app", "app": "photon" } { "command": "start_app", "app": "photon", "params": { "command": "cargo tauri dev", "waitForConnection": true } } { "command": "kill_app", "app": "photon" } { "command": "kill_app", "app": "photon", "params": { "force": true } } { "command": "test_connection" } { "command": "test_connection", "app": "photon" } { "command": "get_task", "params": { "task_id": 42 } } { "command": "get_tasks_by_status", "params": { "status": "working" } } { "command": "get_all_tasks", "params": { "limit": 10 }, "response_format": "detailed" } { "command": "broadcast_to_frontend", "params": { "action": "execute_js", "payload": { "script": "document.title" } } } { "command": "get_snapshot" } { "command": "click", "params": { "uid": "e5" } } { "command": "fill", "params": { "uid": "e3", "value": "test@example.com" } } { "command": "take_screenshot", "params": { "full_page": true } } { "command": "get_console_logs", "params": { "types": ["error", "warn"], "limit": 50 } }
RESPONSE: Returns { success: boolean, data?: unknown, error?: string }
Inputs: command (required), app, params, response_format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of confusing it with another tool. The tool name clearly indicates its purpose, and the internal commands are well-documented.
With a single tool, naming consistency is inherently satisfied. The name 'tauri_debug_command' is descriptive and follows a clear, consistent pattern.
The server exposes only one tool despite covering a broad range of functionality (app lifecycle, tasks, system metrics, UI automation). This is a significant mismatch—the scope warrants multiple focused tools rather than a single oversized one.
The tool bundles a comprehensive set of commands covering app lifecycle, health checks, system metrics, task management (Commander-specific), sessions, UI automation, and more. It covers the main debugging workflows for Tauri apps, though some task mutation operations are absent, leaving minor gaps.
Maintenance
Related MCP Connectors
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
MCP server to assist with JxBrowser development.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for interacting with the Supabase platform
Related MCP Servers
- AlicenseBqualityCmaintenanceA Model Context Protocol server that provides comprehensive Electron application automation, debugging, and observability capabilities through Chrome DevTools Protocol integration.41,981 npm71MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to automate and test Tauri desktop applications through the Model Context Protocol. It provides tools for app management, UI interaction, and state inspection across multiple platforms without requiring CDP dependencies.141MIT
- AlicenseAqualityFmaintenanceRust-based MCP server that lets AI agents natively control and debug Chromium browsers via the Chrome DevTools Protocol (CDP). Single pre-compiled binary, installable with npx @raultov/chrome-debug-mcp, Homebrew or one shell command — no Rust toolchain.3030 npm8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows AI agents to interact with and debug Tauri applications through screenshots, DOM access, input simulation, and more.1,893 npm113MIT