Skip to content
Back to search

mcp-pointer

MCP tool: let you point at DOM elements for your favorite agentic coding tool. Let AI see what you see.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/etsd-tech--mcp-pointer/badge.svg)](/listings/etsd-tech--mcp-pointer)

HTML

<a href="/listings/etsd-tech--mcp-pointer"><img src="/api/listings/etsd-tech--mcp-pointer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install Chrome Extension

**๐ŸŽ‰ Now available on Chrome Web Store!**

Simply click the link above to install from the Chrome Web Store.

<details> <summary>Alternative: Manual Installation</summary>

**Option A: Download from Releases**

1. Go to [GitHub Releases](https://github.com/etsd-tech/mcp-pointer/releases) 2. Download `mcp-pointer-chrome-extension.zip` from the latest release 3. Extract the zip file to a folder on your computer 4. Open Chrome โ†’ Settings โ†’ Extensions โ†’ Developer mode (toggle ON) 5. Click "Load unpacked" and select the extracted folder 6. The MCP Pointer extension should appear in your extensions list 7. **Reload web pages** to activate the extension

**Option B: Build from Source**

1. Clone this repository 2. Follow the build instructions in [CONTRIBUTING.md](./CONTRIBUTING.md) 3. Open Chrome โ†’ Settings โ†’ Extensions โ†’ Developer mode (toggle ON) 4. Click "Load unpacked" and select the `packages/chrome-extension/dist/` folder 5. **Reload web pages** to activate the extension

</details>

2. Configure MCP Server

One command setup for your AI tool:

npx -y @mcp-pointer/server config claude  # or cursor, windsurf, and others - see below

<details> <summary>Other AI Tools & Options</summary>

# For other AI tools
npx -y @mcp-pointer/server config cursor     # Opens Cursor deeplink for automatic installation
npx -y @mcp-pointer/server config windsurf   # Automatically updates Windsurf config file
npx -y @mcp-pointer/server config manual     # Shows manual configuration for other tools

> **Optional:** You can install globally with `npm install -g @mcp-pointer/server` to use `mcp-pointer` instead of `npx -y @mcp-pointer/server`

</details>

After configuration, **restart your coding tool** to load the MCP connection.

> **๐Ÿ”„ Already using MCP Pointer?** Run the config command again to update to auto-updating configuration: > ```bash > npx -y @mcp-pointer/server config <your-tool> # Reconfigures to always use latest version > ```

3. Start Using

1. **Navigate to any webpage** 2. **`Option+Click`** any element to select it 3. **Ask your AI** to analyze the targeted element!

Your AI tool will automatically start the MCP server when needed using the `npx -y @mcp-pointer/server@latest start` command.

**Available MCP Tool:** - `get-pointed-element` โ€“ Returns textual information about the currently pointed DOM element. Optional arguments: - `textDetail`: `0 | 1 | 2` (default `2`) controls how much text to include (`0 = none`, `1 = visible text only`, `2 = visible + hidden`). - `cssLevel`: `0 | 1 | 2 | 3` (default `1`) controls styling detail, from no CSS (0) up to full computed styles (3).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 194 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <img width="1440" height="480" alt="MCP Pointer banner" src="https://github.com/user-attachments/assets/a36d2666-e848-4a80-97b3-466897b244f7" />
  2. [![CI](https://github.com/etsd-tech/mcp-pointer/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/etsd-tech/mcp-pointer/actions/workflows/ci.yml)
  3. [![Release](https://github.com/etsd-tech/mcp-pointer/actions/workflows/release.yml/badge.svg?branch=main)](https://github.com/etsd-tech/mcp-pointer/actions/workflows/release.yml)
  4. [![npm version](https://img.shields.io/npm/v/@mcp-pointer/server?label=Server)](https://www.npmjs.com/package/@mcp-pointer/server)
  5. [![Chrome Extension](https://img.shields.io/github/package-json/v/etsd-tech/mcp-pointer?filename=packages%2Fchrome-extension%2Fpackage.json&label=Chrome-Extension)](https://github.com/etsd-tech/mcp-pointer/releases)
  6. [![License: MIT](https://img.shields.io/github/license/etsd-tech/mcp-pointer?label=License)](https://github.com/etsd-tech/mcp-pointer/blob/main/LICENSE)
  7. # ๐Ÿ‘† MCP Pointer
  8. **Point to browser DOM elements for agentic coding tools via MCP!**
  9. MCP Pointer is a *local* tool combining an MCP Server with a Chrome Extension:
  10. 1. **๐Ÿ–ฅ๏ธ MCP Server** (Node.js package) - Bridges between the browser and AI tools via the Model Context Protocol
  11. 2. **๐ŸŒ Chrome Extension** - Captures DOM element selections in the browser using `Option+Click`
  12. The extension lets you visually select DOM elements in the browser, and the MCP server makes this **textual context** available to agentic coding tools like Claude Code, Cursor, and Windsurf through standardized MCP tools.
  13. ## โœจ Features
  14. - ๐ŸŽฏ **`Option+Click` Selection** - Simply hold `Option` (Alt on Windows) and click any element
  15. - ๐Ÿ“‹ **Complete Element Data** - Text content, CSS classes, HTML attributes, positioning, and styling
  16. - ๐Ÿ’ก **Dynamic Context Control** - Request visible-only text, suppress text entirely, or dial CSS detail from none โ†’ full computed styles per MCP call
  17. - โš›๏ธ **React Component Detection** - Component names and source files via Fiber (experimental)
  18. - ๐Ÿ”— **WebSocket Connection** - Real-time communication between browser and AI tools
  19. - ๐Ÿค– **MCP Compatible** - Works with Claude Code and other MCP-enabled AI tools
  20. ## ๐ŸŽฌ Usage example (video)
  21. https://github.com/user-attachments/assets/98c4adf6-1f05-4c9b-be41-0416ab784e2c
  22. See MCP Pointer in action: `Option+Click` any element in your browser, then ask your agentic coding tool about it (in this example, Claude Code). The AI gets complete textual context about the selected DOM element including CSS properties, url, selector, and more.
  23. ## ๐Ÿš€ Getting Started
  24. ### 1. Install Chrome Extension
  25. **๐ŸŽ‰ Now available on Chrome Web Store!**
  26. [![Install from Chrome Web Store](https://img.shields.io/badge/Chrome_Web_Store-Install-blue?style=for-the-badge&logo=google-chrome)](https://chromewebstore.google.com/detail/mcp-pointer/jfhgaembhafbffidedhpkmnaajdfeiok)
  27. Simply click the link above to install from the Chrome Web Store.
  28. <details>
  29. <summary>Alternative: Manual Installation</summary>
  30. **Option A: Download from Releases**
  31. 1. Go to [GitHub Releases](https://github.com/etsd-tech/mcp-pointer/releases)
  32. 2. Download `mcp-pointer-chrome-extension.zip` from the latest release
  33. 3. Extract the zip file to a folder on your computer
  34. 4. Open Chrome โ†’ Settings โ†’ Extensions โ†’ Developer mode (toggle ON)
  35. 5. Click "Load unpacked" and select the extracted folder
  36. 6. The MCP Pointer extension should appear in your extensions list
  37. 7. **Reload web pages** to activate the extension
  38. **Option B: Build from Source**
  39. 1. Clone this repository
  40. 2. Follow the build instructions in [CONTRIBUTING.md](./CONTRIBUTING.md)
  41. 3. Open Chrome โ†’ Settings โ†’ Extensions โ†’ Developer mode (toggle ON)
  42. 4. Click "Load unpacked" and select the `packages/chrome-extension/dist/` folder
  43. 5. **Reload web pages** to activate the extension
  44. </details>
  45. ### 2. Configure MCP Server
  46. One command setup for your AI tool:
  47. ```bash
  48. npx -y @mcp-pointer/server config claude # or cursor, windsurf, and others - see below
  49. ```
  50. <details>
  51. <summary>Other AI Tools & Options</summary>
  52. ```bash
  53. # For other AI tools
  54. npx -y @mcp-pointer/server config cursor # Opens Cursor deeplink for automatic installation
  55. npx -y @mcp-pointer/server config windsurf # Automatically updates Windsurf config file
  56. npx -y @mcp-pointer/server config manual # Shows manual configuration for other tools
  57. ```
  58. > **Optional:** You can install globally with `npm install -g @mcp-pointer/server` to use `mcp-pointer` instead of `npx -y @mcp-pointer/server`
  59. </details>
  60. After configuration, **restart your coding tool** to load the MCP connection.
  61. > **๐Ÿ”„ Already using MCP Pointer?** Run the config command again to update to auto-updating configuration:
  62. > ```bash
  63. > npx -y @mcp-pointer/server config <your-tool> # Reconfigures to always use latest version
  64. > ```
  65. ### 3. Start Using
  66. 1. **Navigate to any webpage**
  67. 2. **`Option+Click`** any element to select it
  68. 3. **Ask your AI** to analyze the targeted element!
  69. Your AI tool will automatically start the MCP server when needed using the `npx -y @mcp-pointer/server@latest start` command.
  70. **Available MCP Tool:**
  71. - `get-pointed-element` โ€“ Returns textual information about the currently pointed DOM element. Optional arguments:
  72. - `textDetail`: `0 | 1 | 2` (default `2`) controls how much text to include (`0 = none`, `1 = visible text only`, `2 = visible + hidden`).
  73. - `cssLevel`: `0 | 1 | 2 | 3` (default `1`) controls styling detail, from no CSS (0) up to full computed styles (3).
  74. ## ๐ŸŽฏ How It Works
  75. 1. **Element Selection**: Content script captures `Option+Click` events
  76. 2. **Data Extraction**: Analyzes element structure, CSS, and framework info
  77. 3. **WebSocket Transport**: Sends data to MCP server on port 7007
  78. 4. **MCP Protocol**: Makes data available to AI tools via MCP tools
  79. 5. **AI Analysis**: Your assistant can now see and analyze the element!
  80. ## ๐ŸŽจ Element Data Extracted
  81. - **Basic Info**: Tag name, ID, classes, text content
  82. - **CSS Properties**: Display, position, colors, dimensions
  83. - **Component Info**: React component names and source files (experimental)
  84. - **Attributes**: All HTML attributes
  85. - **Position**: Exact coordinates and dimensions
  86. - **Source Hints**: File paths and component origins
  87. ## ๐Ÿ” Framework Support
  88. - โš›๏ธ **React** - Component names and source files via Fiber (experimental)
  89. - ๐Ÿ“ฆ **Generic HTML/CSS/JS** - Full support for any web content
  90. - ๐Ÿ”ฎ **Planned** - Vue component detection (PRs appreciated)
  91. ## ๐ŸŒ Browser Support
  92. - โœ… **Chrome** - Full support (tested)
  93. - ๐ŸŸก **Chromium-based browsers** - Should work (Edge, Brave, Arc - load built extension manually)
  94. ## ๐Ÿ› Troubleshooting
  95. ### Extension Not Connecting
  96. 1. Make sure MCP server is running: `npx -y @mcp-pointer/server@latest start`
  97. 2. Check browser console for WebSocket errors
  98. 3. Verify port 7007 is not blocked by firewall
  99. ### MCP Tools Not Available
  100. 1. Restart your AI assistant after installing
  101. 2. Check MCP configuration: `mcp-pointer config <your-tool>`
  102. 3. Verify server is running: `npx -y @mcp-pointer/server@latest start`
  103. ### Elements Not Highlighting
  104. 1. Some pages block content scripts (chrome://, etc.)
  105. 2. Try refreshing the page
  106. 3. Check if targeting is enabled (click extension icon)
  107. ## ๐Ÿš€ Roadmap
  108. ### 1. **Dynamic Context Control**
  109. - Full raw context transferred to server
  110. - LLM-configurable detail levels (visible text only, all text, CSS levels)
  111. - Progressive refinement options / token-conscious data fetching
  112. ### 2. **Visual Content Support** (for multimodal LLMs)
  113. - Base64 encoding for images (img tags)
  114. - Screenshot capture of selected elements
  115. - Separate MCP tool for direct visual content retrieval
  116. ### 3. **Enhanced Framework Support**
  117. - Vue.js component detection
  118. - Better React support (React 19 removed `_debugSource`, affecting source mapping in dev builds)
  119. ### 4. **Multi Select**
  120. - Having the ability to select multiple DOM elements
  121. - https://github.com/etsd-tech/mcp-pointer/pull/9
  122. ## ๐Ÿ“ License
  123. MIT License - see LICENSE file for details
  124. ## ๐Ÿค Contributing
  125. We welcome contributions! Please see our [CONTRIBUTING.md](./CONTRIBUTING.md) guide for development setup and guidelines.
  126. ---
  127. *Inspired by tools like [Click-to-Component](https://github.com/ericclemmons/click-to-component) for component development workflows.*
  128. ---
  129. **Made with โค๏ธ for AI-powered web development**
  130. *Now your AI can analyze any element you point at with `Option+Click`! ๐Ÿ‘†*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.