Pointer MCP server
Chrome에서 Option+Click으로 선택한 DOM 요소를 검사하여 텍스트, CSS, 속성 및 위치 데이터를 AI 클라이언트에 전달합니다.
다른 이름 etsd-tech/mcp-pointer
- 스타
- 600
- Tools
- 1
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2025년 11월 12일
- 라이선스
- MIT
Pointer MCP란?
Pointer은(는) MCP server입니다. Chrome에서 Option+Click으로 선택한 DOM 요소를 검사하여 텍스트, CSS, 속성 및 위치 데이터를 AI 클라이언트에 전달합니다. 1개 도구를 제공합니다. 예: get-pointed-element.
프로젝트 README에서 생성된 요약
Pointer MCP server 정보
mcp-pointer는 Chrome에서 요소를 클릭함으로써 에이전트 기반 코딩 도구에 시각적 컨텍스트를 제공합니다. 이 로컬 설정은 Node.js MCP server와 Chrome extension을 결합하여 브라우저와 AI 어시스턴트 사이의 간극을 메워줍니다. Option 또는 Alt 키를 누른 채 요소를 클릭하면, AI가 분석할 수 있도록 해당 요소의 특정 데이터를 캡처합니다.
개발자는 이를 통해 Claude Code, Cursor 또는 Windsurf와 같은 도구에 상세한 DOM 정보를 입력할 수 있습니다. 시스템은 포트 7007의 WebSocket 연결을 사용하여 브라우저에서 서버로 데이터를 전송합니다. get-pointed-element tool을 통해 텍스트 상세 수준과 스타일 제외부터 전체 computed properties까지 포함하는 CSS 깊이 등 전송되는 정보의 양을 제어할 수 있습니다.
표준 HTML 외에도, 이 서버는 Fiber를 통해 React 컴포넌트 이름과 소스 파일을 실험적으로 감지할 수 있습니다. 이는 코딩 세션 중에 AI 에이전트가 특정 UI 컴포넌트의 정확한 구조, 위치 및 스타일을 이해해야 하는 웹 개발자에게 특화된 유틸리티를 제공합니다.
활용 사례
- 1특정 UI 컴포넌트 분석방금 클릭한 특정 버튼이나 div의 스타일 또는 구조를 AI 에이전트에게 설명하도록 요청합니다.
- 2CSS 및 레이아웃 문제 디버깅레이아웃 버그를 해결하기 위해 DOM 요소의 정확한 computed styles와 위치 정보를 AI 어시스턴트에게 제공합니다.
- 3React 컴포넌트 출처 식별실험적 기능을 사용하여 클릭한 요소가 어떤 React 컴포넌트 및 소스 파일에 해당하는지 찾습니다.
- 4컨텍스트 윈도우 토큰 관리AI로 전송되는 텍스트 또는 CSS 데이터 양을 제한하여 대화 효율성을 유지합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Pointer MCP 도구 1
README에서 감지됨get-pointed-element
| get-pointed-element | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능etsd-tech/mcp-pointer is public and reachablegithub.com/etsd-tech/mcp-pointer ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2025-11-12github.com/etsd-tech/mcp-pointer ↗결함 발견
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음1 tool description and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
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! 👆
Pointer MCP 질문
Pointer MCP는 어떤 도구를 제공하나요?
1개 도구를 제공합니다. 예: get-pointed-element.
MCP Pointer로 DOM 요소를 어떻게 선택하나요?
Option(Windows의 경우 Alt) 키를 누른 상태에서 페이지의 요소를 클릭하면 Chrome extension이 해당 선택 영역을 캡처합니다.
어떤 AI 코딩 도구와 MCP Pointer를 함께 사용할 수 있나요?
Claude Code, Cursor, Windsurf와 호환되며, 단일 npx 명령어로 설정할 수 있습니다. README에 따르면 Claude Code 및 other MCP 지원 AI 도구에서 작동합니다.
이 서버가 제공하는 MCP tool은 무엇인가요?
get-pointed-element라는 이름의 단일 tool을 제공하며, 현재 가리키고 있는 DOM 요소에 대한 텍스트 정보를 반환합니다. textDetail 및 cssLevel 인자를 선택적으로 사용할 수 있습니다.
반환되는 CSS나 텍스트의 양을 조절할 수 있나요?
네. textDetail(0-2)로 텍스트 포함 여부를 제어하고, cssLevel(0-3)로 CSS 스타일 상세도를 제어할 수 있습니다. 스타일을 제외한 상태부터 전체 computed styles까지 설정 가능합니다.
MCP Pointer는 어떤 포트를 사용하나요?
extension은 포트 7007의 WebSocket을 통해 MCP server로 요소 데이터를 전송합니다.