Serveur MCP Pointer
Permet à un client IA d'inspecter l'élément DOM que vous sélectionnez via Option+Click dans Chrome, en renvoyant le texte, le CSS, les attributs et les données de position.
Aussi connu sous etsd-tech/mcp-pointer
- Étoiles
- 600
- Outils
- 1
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 12 nov. 2025
- Licence
- MIT
Qu'est-ce que Pointer MCP ?
Pointer est un serveur MCP. Permet à un client IA d'inspecter l'élément DOM que vous sélectionnez via Option+Click dans Chrome, en renvoyant le texte, le CSS, les attributs et les données de position. Il expose 1 outil, comme get-pointed-element.
Résumé généré à partir du README du projet
À propos du MCP server Pointer
mcp-pointer permet d'apporter un contexte visuel aux outils de codage agentiques en cliquant simplement sur des éléments dans Chrome. Cette configuration locale combine un MCP server Node.js avec une extension Chrome pour combler le fossé entre votre navigateur et vos assistants IA. En maintenant la touche Option ou Alt enfoncée tout en cliquant sur un élément, vous capturez ses données spécifiques pour que votre IA puisse les analyser.
Les développeurs utilisent cet outil pour injecter des informations DOM détaillées dans des outils tels que Claude Code, Cursor ou Windsurf. Le système utilise une connexion WebSocket sur le port 7007 pour transférer les données du navigateur vers le serveur. Grâce à l'outil get-pointed-element, vous pouvez contrôler la quantité d'informations envoyées, y compris les niveaux de détail textuel et la profondeur du CSS, allant de l'absence de styles aux propriétés calculées complètes.
Au-delà du HTML standard, le serveur peut détecter de manière expérimentale les noms de composants React et les fichiers sources via Fiber. Cela en fait un utilitaire spécialisé pour les développeurs web qui ont besoin que leurs agents IA comprennent la structure, le positionnement et le style exacts de composants UI spécifiques lors d'une session de codage.
Ce que vous pouvez faire avec
- 1Analyser des composants UI spécifiquesDemandez à votre agent IA d'expliquer le style ou la structure d'un bouton ou d'une div spécifique que vous venez de cliquer.
- 2Déboguer des problèmes de CSS et de mise en pageFournissez à un assistant IA les styles calculés et le positionnement exacts d'un élément DOM pour résoudre des bugs de mise en page.
- 3Identifier l'origine des composants ReactUtilisez la fonctionnalité expérimentale pour trouver quel composant React et quel fichier source correspondent à l'élément cliqué.
- 4Gérer les tokens de la fenêtre de contexteLimitez la quantité de texte ou de données CSS envoyées à l'IA pour maintenir l'efficacité de la conversation.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Outils MCP Pointer 1
Détectés depuis le READMEget-pointed-element
| get-pointed-element | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleetsd-tech/mcp-pointer is public and reachablegithub.com/etsd-tech/mcp-pointer ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2025-11-12github.com/etsd-tech/mcp-pointer ↗Faille
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle1 tool description and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHub👆 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! 👆
Questions sur Pointer MCP
Quels outils Pointer MCP fournit-il ?
Il expose 1 outil, dont get-pointed-element.
Comment sélectionner un élément DOM avec MCP Pointer ?
Maintenez la touche Option (Alt sur Windows) enfoncée et cliquez sur n'importe quel élément de la page ; l'extension Chrome capture la sélection.
Quels outils de codage IA sont compatibles avec MCP Pointer ?
Il fonctionne avec Claude Code, Cursor et Windsurf, et peut être configuré avec une simple commande npx. Le README précise qu'il fonctionne avec Claude Code et d'autres outils IA compatibles MCP.
Quel outil MCP le serveur expose-t-il ?
Un outil unique nommé get-pointed-element renvoie les informations textuelles de l'élément DOM actuellement pointé, avec des arguments optionnels textDetail et cssLevel.
Puis-je contrôler la quantité de CSS ou de texte renvoyée ?
Oui. textDetail (0-2) contrôle l'inclusion du texte et cssLevel (0-3) contrôle le niveau de détail du style, allant de l'absence de CSS aux styles calculés complets.
Quel port MCP Pointer utilise-t-il ?
L'extension envoie les données de l'élément au MCP server via WebSocket sur le port 7007.