MCP server Pointer
Permite que um cliente de IA inspecione o elemento DOM que você selecionar via Option+Click no Chrome, retornando texto, CSS, atributos e dados de posicionamento.
Também conhecido como etsd-tech/mcp-pointer
- Stars
- 600
- Ferramentas
- 1
- Downloads, 30 dias
- —
- Versão mais recente
- —
- Último commit
- 12 de nov. de 2025
- Licença
- MIT
O que é o MCP Pointer?
Pointer é um MCP server. Permite que um cliente de IA inspecione o elemento DOM que você selecionar via Option+Click no Chrome, retornando texto, CSS, atributos e dados de posicionamento. Ele expõe 1 ferramenta, como get-pointed-element.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Pointer
O mcp-pointer permite fornecer contexto visual para ferramentas de codificação agênticas ao clicar em elementos no Chrome. Esta configuração local combina um MCP server em Node.js com uma extensão do Chrome para criar uma ponte entre seu navegador e assistentes de IA. Ao segurar a tecla Option ou Alt e clicar em qualquer elemento, você captura os dados específicos dele para que sua IA possa analisar.
Desenvolvedores utilizam isso para alimentar ferramentas como Claude Code, Cursor ou Windsurf com informações detalhadas do DOM. O sistema utiliza uma conexão WebSocket na porta 7007 para transferir dados do navegador para o servidor. Por meio da ferramenta get-pointed-element, você pode controlar a quantidade de informação enviada, incluindo níveis de detalhamento de texto e profundidade de CSS, variando de nenhum estilo até propriedades computadas completas.
Além do HTML padrão, o servidor pode detectar experimentalmente nomes de componentes React e arquivos de origem via Fiber. Isso o torna um utilitário especializado para desenvolvedores web que precisam que seus agentes de IA compreendam a estrutura, o posicionamento e a estilização exata de componentes de UI específicos durante uma sessão de codificação.
O que você pode fazer com ele
- 1Analisar componentes de UI específicosPeça ao seu agente de IA para explicar a estilização ou a estrutura de um botão ou div específico que você acabou de clicar.
- 2Depurar problemas de CSS e layoutForneça a um assistente de IA os estilos computados e o posicionamento exatos de um elemento DOM para solucionar bugs de layout.
- 3Identificar origens de componentes ReactUse o recurso experimental para descobrir qual componente React e arquivo de origem correspondem a um elemento clicado.
- 4Gerenciar tokens da janela de contextoLimite a quantidade de texto ou dados de CSS enviados para a IA para manter a conversa eficiente.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Ferramentas do MCP Pointer 1
Detectadas a partir do READMEget-pointed-element
| get-pointed-element | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessíveletsd-tech/mcp-pointer is public and reachablegithub.com/etsd-tech/mcp-pointer ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2025-11-12github.com/etsd-tech/mcp-pointer ↗Problema encontrado
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo1 tool description and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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! 👆
Perguntas sobre o MCP Pointer
Quais ferramentas o MCP Pointer oferece?
Ele expõe 1 ferramenta, incluindo get-pointed-element.
Como seleciono um elemento DOM com o MCP Pointer?
Segure Option (Alt no Windows) e clique em qualquer elemento da página; a extensão do Chrome captura a seleção.
Quais ferramentas de codificação com IA funcionam com o MCP Pointer?
Ele funciona com Claude Code, Cursor e Windsurf, e pode ser configurado com um único comando npx. O README informa que ele funciona com Claude Code e outras ferramentas de IA compatíveis com MCP.
Qual ferramenta MCP o servidor expõe?
Uma única ferramenta chamada get-pointed-element que retorna informações textuais sobre o elemento DOM apontado no momento, com argumentos opcionais textDetail e cssLevel.
Posso controlar quanto CSS ou texto é retornado?
Sim. O textDetail (0-2) controla a inclusão de texto e o cssLevel (0-3) controla o detalhamento do estilo, desde nenhum CSS até os estilos computados completos.
Qual porta o MCP Pointer utiliza?
A extensão envia os dados do elemento para o MCP server via WebSocket na porta 7007.