Tauri MCP Server

This is a Model Context Protocol (MCP) server that connects to a Tauri application's socket server to provide tools for controlling and interacting with the Tauri application.

Overview

The server bridges MCP clients (like LLMs) with a Tauri application by:

1. Connecting to the Tauri socket server via a Unix socket/named pipe
2. Providing MCP tools that map to Tauri functionality
3. Running as a stdio-based MCP server that any MCP client can use

Available Tools

The server provides the following MCP tools:

take_screenshot

Take a screenshot of a Tauri application window.

Parameters:

• window_label (optional): The label of the window to capture (default: "main")
• quality (optional): JPEG quality from 1-100
• max_width (optional): Maximum image width in pixels
• max_size_mb (optional): Maximum file size in MB

Returns:

• Image content with base64-encoded data

execute_js

Execute JavaScript code in a Tauri window.

Parameters:

• code: JavaScript code to execute
• window_label (optional): The window to execute in (default: "main")
• timeout_ms (optional): Maximum execution time in milliseconds

Returns:

• The result of the JavaScript execution, serialized as a string

get_dom

Get the HTML DOM content of a Tauri window.

Parameters:

• window_label (optional): The window to get the DOM from (default: "main")

Returns:

• HTML content as a string

manage_window

Control Tauri application windows.

Parameters:

• operation: Operation to perform (e.g., "focus", "minimize", "maximize", "setPosition", "setSize")
• window_label (optional): Target window (default: "main")
• x (optional): X position for setPosition
• y (optional): Y position for setPosition
• width (optional): Width for setSize
• height (optional): Height for setSize

Returns:

• Success message

manage_local_storage

Manage localStorage in the Tauri webview.

Parameters:

• action: Action to perform ("get", "set", "remove", "clear", or "keys")
• key (optional): Key to get, set, or remove
• value (optional): Value to set
• window_label (optional): Target window (default: "main")

Returns:

• Operation result

Setup and Usage

1. Ensure the Tauri application is running with the socket server active
2. Start this MCP server
3. Connect your MCP client to this server
4. Use the tools to interact with the Tauri application

The server connects to the Tauri socket at /private/tmp/tauri-mcp.sock.

Error Handling

All tools follow the MCP error reporting convention:

• If a tool succeeds, it returns a result object with content
• If a tool fails, it returns an object with isError: true and an error message in content

Example

Using the take_screenshot tool from an MCP client:

{
  "name": "take_screenshot",
  "arguments": {
    "window_label": "main",
    "quality": 90,
    "max_width": 1920
  }
}

The response will include base64-encoded image data that can be rendered or saved as a JPEG file.