Pointer MCP server
Memungkinkan AI client untuk menginspeksi elemen DOM yang Anda Option+Click di Chrome, lalu mengembalikan data teks, CSS, atribut, dan posisi.
Juga dikenal sebagai etsd-tech/mcp-pointer
- Stars
- 600
- Tools
- 1
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 12 Nov 2025
- Lisensi
- MIT
Apa itu Pointer MCP?
Pointer adalah MCP server. Memungkinkan AI client untuk menginspeksi elemen DOM yang Anda Option+Click di Chrome, lalu mengembalikan data teks, CSS, atribut, dan posisi. Server ini menyediakan 1 tool, seperti get-pointed-element.
Ringkasan dibuat dari README proyek
Tentang Pointer MCP server
mcp-pointer memungkinkan Anda memberikan konteks visual ke tool coding agentic hanya dengan mengklik elemen di Chrome. Setup lokal ini menggabungkan Node.js MCP server dengan ekstensi Chrome untuk menjembatani celah antara browser Anda dan asisten AI. Dengan menahan tombol Option atau Alt sambil mengklik elemen apa pun, Anda menangkap data spesifik elemen tersebut untuk dianalisis oleh AI Anda.
Developer menggunakan ini untuk memasukkan informasi DOM yang mendetail ke dalam tool seperti Claude Code, Cursor, atau Windsurf. Sistem ini menggunakan koneksi WebSocket pada port 7007 untuk mentransfer data dari browser ke server. Melalui tool get-pointed-element, Anda dapat mengontrol jumlah informasi yang dikirim, termasuk level detail teks dan kedalaman CSS mulai dari tanpa style hingga full computed properties.
Selain HTML standar, server ini secara eksperimental dapat mendeteksi nama komponen React dan file sumber melalui Fiber. Hal ini menjadikannya utility khusus bagi web developer yang membutuhkan AI agent mereka untuk memahami struktur, posisi, dan styling yang tepat dari komponen UI spesifik selama sesi coding.
Apa yang bisa Anda lakukan dengannya
- 1Menganalisis komponen UI spesifikMinta AI agent Anda untuk menjelaskan styling atau struktur dari tombol atau div tertentu yang baru saja Anda klik.
- 2Debug masalah CSS dan layoutBerikan asisten AI computed styles dan posisi yang tepat dari sebuah elemen DOM untuk membantu troubleshooting bug layout.
- 3Mengidentifikasi asal komponen ReactGunakan fitur eksperimental untuk menemukan komponen React dan file sumber mana yang sesuai dengan elemen yang diklik.
- 4Mengelola token context windowBatasi jumlah data teks atau CSS yang dikirim ke AI agar percakapan tetap efisien.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool Pointer MCP 1
Terdeteksi dari READMEget-pointed-element
| get-pointed-element | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauetsd-tech/mcp-pointer is public and reachablegithub.com/etsd-tech/mcp-pointer ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2025-11-12github.com/etsd-tech/mcp-pointer ↗Temuan
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model1 tool description and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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! 👆
Pertanyaan tentang Pointer MCP
Tool apa yang disediakan Pointer MCP?
Server ini menyediakan 1 tool, termasuk get-pointed-element.
Bagaimana cara memilih elemen DOM dengan MCP Pointer?
Tahan tombol Option (Alt di Windows) dan klik elemen apa pun di halaman; ekstensi Chrome akan menangkap pilihan tersebut.
Tool coding AI mana saja yang kompatibel dengan MCP Pointer?
Tool ini bekerja dengan Claude Code, Cursor, dan Windsurf, serta dapat dikonfigurasi dengan satu perintah npx. README mencatat bahwa tool ini bekerja dengan Claude Code dan tool AI berbasis MCP lainnya.
MCP tool apa yang disediakan oleh server ini?
Satu tool bernama get-pointed-element yang mengembalikan informasi tekstual tentang elemen DOM yang sedang ditunjuk, dengan argumen opsional textDetail dan cssLevel.
Bisakah saya mengatur seberapa banyak CSS atau teks yang dikembalikan?
Ya. textDetail (0-2) mengontrol penyertaan teks dan cssLevel (0-3) mengontrol detail styling, mulai dari tanpa CSS hingga full computed styles.
Port mana yang digunakan oleh MCP Pointer?
Ekstensi mengirimkan data elemen ke MCP server melalui WebSocket pada port 7007.