Pointer MCP server
Ermöglicht es einem AI-Client, das DOM-Element zu inspizieren, das du in Chrome mit Option+Click auswählst, und liefert Text, CSS, Attribute sowie Positionsdaten zurück.
Auch bekannt als etsd-tech/mcp-pointer
- Stars
- 600
- Tools
- 1
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 12. Nov. 2025
- Lizenz
- MIT
Was ist Pointer MCP?
Pointer ist ein MCP server. Ermöglicht es einem AI-Client, das DOM-Element zu inspizieren, das du in Chrome mit Option+Click auswählst, und liefert Text, CSS, Attribute sowie Positionsdaten zurück. Er stellt 1 Tool bereit, etwa get-pointed-element.
Zusammenfassung generiert aus dem README des Projekts
Über Pointer MCP server
mcp-pointer ermöglicht es, agentischen Coding-Tools visuellen Kontext zu geben, indem du einfach Elemente in Chrome anklickst. Dieses lokale Setup kombiniert einen Node.js MCP server mit einer Chrome-Extension, um die Lücke zwischen deinem Browser und AI-Assistenten zu schließen. Durch Halten der Option- oder Alt-Taste und das Klicken auf ein beliebiges Element erfasst du dessen spezifische Daten für deine AI zur Analyse.
Entwickler nutzen dies, um detaillierte DOM-Informationen in Tools wie Claude Code, Cursor oder Windsurf einzuspeisen. Das System nutzt eine WebSocket-Verbindung auf Port 7007, um Daten vom Browser zum Server zu übertragen. Über das get-pointed-element Tool kannst du die Menge der gesendeten Informationen steuern, einschließlich der Textdetailstufen und der CSS-Tiefe, die von gar keinen Styles bis hin zu vollständigen berechneten Eigenschaften reicht.
Über Standard-HTML hinaus kann der Server experimentell React-Komponentennamen und Quelldateien via Fiber erkennen. Dies macht es zu einem spezialisierten Utility für Webentwickler, die benötigen, dass ihre AI-Agents die exakte Struktur, Positionierung und das Styling spezifischer UI-Komponenten während einer Coding-Session verstehen.
Was du damit machen kannst
- 1Spezifische UI-Komponenten analysierenBitte deinen AI-Agenten, das Styling oder die Struktur eines spezifischen Buttons oder Divs zu erklären, das du gerade angeklickt hast.
- 2CSS- und Layout-Probleme debuggenGib einem AI-Assistenten die exakten berechneten Styles und die Positionierung eines DOM-Elements, um Layout-Bugs zu beheben.
- 3React-Komponenten-Ursprünge identifizierenNutze das experimentelle Feature, um herauszufinden, welche React-Komponente und welche Quelldatei zu einem angeklickten Element gehören.
- 4Context Window Tokens verwaltenBegrenze die Menge an Text- oder CSS-Daten, die an die AI gesendet werden, um die Konversation effizient zu halten.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Pointer MCP tools 1
Erkannt aus dem READMEget-pointed-element
| get-pointed-element | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbaretsd-tech/mcp-pointer is public and reachablegithub.com/etsd-tech/mcp-pointer ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2025-11-12github.com/etsd-tech/mcp-pointer ↗Befund
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell1 tool description and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen👆 MCP Pointer
Point to browser DOM elements for agentic coding tools via MCP!
MCP Pointer is a local tool combining an MCP Server with a Chrome Extension:
- 🖥️ MCP Server (Node.js package) - Bridges between the browser and AI tools via the Model Context Protocol
- 🌐 Chrome Extension - Captures DOM element selections in the browser using
Option+Click
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.
✨ Features
- 🎯
Option+ClickSelection - Simply holdOption(Alt on Windows) and click any element - 📋 Complete Element Data - Text content, CSS classes, HTML attributes, positioning, and styling
- 💡 Dynamic Context Control - Request visible-only text, suppress text entirely, or dial CSS detail from none → full computed styles per MCP call
- ⚛️ React Component Detection - Component names and source files via Fiber (experimental)
- 🔗 WebSocket Connection - Real-time communication between browser and AI tools
- 🤖 MCP Compatible - Works with Claude Code and other MCP-enabled AI tools
🎬 Usage example (video)
https://github.com/user-attachments/assets/98c4adf6-1f05-4c9b-be41-0416ab784e2c
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.
🚀 Getting Started
1. Install Chrome Extension
🎉 Now available on Chrome Web Store!
Simply click the link above to install from the Chrome Web Store.
Option A: Download from Releases
- Go to GitHub Releases
- Download
mcp-pointer-chrome-extension.zipfrom the latest release - Extract the zip file to a folder on your computer
- Open Chrome → Settings → Extensions → Developer mode (toggle ON)
- Click "Load unpacked" and select the extracted folder
- The MCP Pointer extension should appear in your extensions list
- Reload web pages to activate the extension
Option B: Build from Source
- Clone this repository
- Follow the build instructions in CONTRIBUTING.md
- Open Chrome → Settings → Extensions → Developer mode (toggle ON)
- Click "Load unpacked" and select the
packages/chrome-extension/dist/folder - Reload web pages to activate the extension
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
# 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/serverto usemcp-pointerinstead ofnpx -y @mcp-pointer/server
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:
npx -y @mcp-pointer/server config <your-tool> # Reconfigures to always use latest version
3. Start Using
- Navigate to any webpage
Option+Clickany element to select it- 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(default2) controls how much text to include (0 = none,1 = visible text only,2 = visible + hidden).cssLevel:0 | 1 | 2 | 3(default1) controls styling detail, from no CSS (0) up to full computed styles (3).
🎯 How It Works
- Element Selection: Content script captures
Option+Clickevents - Data Extraction: Analyzes element structure, CSS, and framework info
- WebSocket Transport: Sends data to MCP server on port 7007
- MCP Protocol: Makes data available to AI tools via MCP tools
- AI Analysis: Your assistant can now see and analyze the element!
🎨 Element Data Extracted
- Basic Info: Tag name, ID, classes, text content
- CSS Properties: Display, position, colors, dimensions
- Component Info: React component names and source files (experimental)
- Attributes: All HTML attributes
- Position: Exact coordinates and dimensions
- Source Hints: File paths and component origins
🔍 Framework Support
- ⚛️ React - Component names and source files via Fiber (experimental)
- 📦 Generic HTML/CSS/JS - Full support for any web content
- 🔮 Planned - Vue component detection (PRs appreciated)
🌐 Browser Support
- ✅ Chrome - Full support (tested)
- 🟡 Chromium-based browsers - Should work (Edge, Brave, Arc - load built extension manually)
🐛 Troubleshooting
Extension Not Connecting
- Make sure MCP server is running:
npx -y @mcp-pointer/server@latest start - Check browser console for WebSocket errors
- Verify port 7007 is not blocked by firewall
MCP Tools Not Available
- Restart your AI assistant after installing
- Check MCP configuration:
mcp-pointer config <your-tool> - Verify server is running:
npx -y @mcp-pointer/server@latest start
Elements Not Highlighting
- Some pages block content scripts (chrome://, etc.)
- Try refreshing the page
- Check if targeting is enabled (click extension icon)
🚀 Roadmap
1. Dynamic Context Control
- Full raw context transferred to server
- LLM-configurable detail levels (visible text only, all text, CSS levels)
- Progressive refinement options / token-conscious data fetching
2. Visual Content Support (for multimodal LLMs)
- Base64 encoding for images (img tags)
- Screenshot capture of selected elements
- Separate MCP tool for direct visual content retrieval
3. Enhanced Framework Support
- Vue.js component detection
- Better React support (React 19 removed
_debugSource, affecting source mapping in dev builds)
4. Multi Select
- Having the ability to select multiple DOM elements
- https://github.com/etsd-tech/mcp-pointer/pull/9
📝 License
MIT License - see LICENSE file for details
🤝 Contributing
We welcome contributions! Please see our CONTRIBUTING.md guide for development setup and guidelines.
Inspired by tools like Click-to-Component for component development workflows.
Made with ❤️ for AI-powered web development
Now your AI can analyze any element you point at with Option+Click! 👆
Pointer MCP Fragen
Welche Tools bietet Pointer MCP?
Er stellt 1 Tool bereit, darunter get-pointed-element.
Wie wähle ich mit MCP Pointer ein DOM-Element aus?
Halte die Option-Taste (Alt unter Windows) gedrückt und klicke auf ein beliebiges Element auf der Seite; die Chrome-Extension erfasst die Auswahl dann automatisch.
Welche AI-Coding-Tools funktionieren mit MCP Pointer?
Es funktioniert mit Claude Code, Cursor und Windsurf und kann mit einem einzigen npx-Befehl konfiguriert werden. Im README wird erwähnt, dass es mit Claude Code und anderen MCP-fähigen AI-Tools funktioniert.
Welches MCP Tool stellt der Server bereit?
Ein einzelnes Tool namens get-pointed-element liefert Textinformationen über das aktuell ausgewählte DOM-Element zurück, mit optionalen Argumenten für textDetail und cssLevel.
Kann ich steuern, wie viel CSS oder Text zurückgegeben wird?
Ja. textDetail (0-2) steuert die Einbeziehung von Text und cssLevel (0-3) die Detailtiefe des CSS, von gar keinem CSS bis hin zu vollständigen berechneten Styles.
Welchen Port nutzt MCP Pointer?
Die Extension sendet Elementdaten über WebSocket auf Port 7007 an den MCP server.