DOM Ghost by Model Context Protocol

DOM Ghost is a command-line tool that enables AI models to interact with browser DOM elements through a Chrome extension. It serves as a bridge between AI tools and web applications, allowing AI agents to manipulate and inspect web page elements programmatically.

Usage

npx dom-ghost-mcp <your-api-token>

Prerequisites

1. A valid API token from DOM Ghost
2. The DOM Ghost Chrome extension installed in your browser

Usage

Basic Usage

Run the tool with your API token as the only argument:

npx dom-ghost-mcp "8bacfe0f-e043-4566-b98f-919eeb9c6428"

This will start a Model Context Protocol (MCP) server that connects to your active browser session through the DOM Ghost extension.

Available Tools

DOM Ghost provides the following tools for DOM interaction:

css_dom_tree

Get a CSS selector tree structure for the body element of the current page, helping you construct selectors for specific elements.

ui_screenshot

Capture a screenshot of a DOM element using a CSS selector.

Example:

(MCP)(payload: {"targetCssSelector":"#myElement"})

dom_snapshot

Retrieve a snapshot of a DOM element using a CSS selector.

Example:

(MCP)(payload: {"targetCssSelector":"#myElement"})

manipulate

Perform various DOM manipulations on elements, including:

• Setting values in form fields
• Appending/replacing elements
• Clicking, focusing, and hovering
• Managing attributes
• Scrolling
• And many more

Example:

(MCP)(payload: {
  "actions": [
    {"targetCssSelector": "#username", "method": "setValue", "value": "johndoe"},
    {"targetCssSelector": "#submitButton", "method": "click"}
  ],
  "screenshotBeforeAndAfter": true,
  "parentContainerCssSelector": "#formContainer"
})

How It Works

1. You run the DOM Ghost CLI with your API token
2. The tool establishes a connection with your browser through the DOM Ghost extension
3. AI models can then send commands through the MCP interface to interact with web pages
4. Results are returned to the AI model for further processing

Getting an API Token

Visit DOM Ghost to create an account and obtain your API token.

License

This project is licensed under CC BY-NC-SA 4.0