Pointer MCPサーバー
ChromeでOption+ClickしたDOM要素をAIクライアントが検査できるようにし、テキスト、CSS、属性、および位置データを返します。
別名 etsd-tech/mcp-pointer
- スター
- 600
- ツール
- 1
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2025年11月12日
- ライセンス
- MIT
Pointer MCPとは
PointerはMCPサーバーです。 ChromeでOption+ClickしたDOM要素をAIクライアントが検査できるようにし、テキスト、CSS、属性、および位置データを返します。. 1個のツールを提供しており、get-pointed-elementなどがあります。
プロジェクトのREADMEから生成された概要
Pointer MCP server について
mcp-pointerは、Chromeで要素をクリックすることで、エージェント型コーディングツールに視覚的なコンテキストを提供します。このローカルセットアップは、Node.jsのMCP serverとChrome拡張機能を組み合わせることで、ブラウザとAIアシスタントの間のギャップを埋めます。OptionまたはAltキーを押しながら要素をクリックするだけで、AIが分析するための特定のデータをキャプチャできます。
開発者はこれを使用して、Claude Code、Cursor、Windsurfなどのツールに詳細なDOM情報を入力できます。システムはポート7007のWebSocket接続を使用して、ブラウザからサーバーへデータを転送します。get-pointed-elementツールを通じて、テキストの詳細レベルや、スタイルなしから完全な計算済みプロパティまでのCSSの深さなど、送信される情報の量を制御できます。
標準的なHTMLに加えて、このサーバーはFiberを介してReactコンポーネント名やソースファイルを実験的に検出できます。これにより、コーディングセッション中にAIエージェントに特定のUIコンポーネントの正確な構造、配置、スタイリングを理解させる必要があるWeb開発者向けの特化型ユーティリティとなります。
できること
- 1特定のUIコンポーネントの分析クリックした特定のボタンやdivのスタイリングや構造について、AIエージェントに説明させます。
- 2CSSとレイアウトの問題のデバッグレイアウトのバグをトラブルシューティングするために、DOM要素の正確な計算済みスタイルと配置を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拡張機能が選択内容をキャプチャします。
どのAIコーディングツールがMCP Pointerに対応していますか?
Claude Code、Cursor、Windsurfで動作し、単一のnpxコマンドで設定可能です。READMEには、Claude Codeやその他のMCP対応AIツールで動作することが記載されています。
このサーバーはどのようなMCPツールを公開していますか?
get-pointed-elementという名前のツールが1つ提供されます。これは、現在指しているDOM要素に関するテキスト情報を返し、オプションでtextDetailおよびcssLevel引数を使用できます。
返されるCSSやテキストの量を制御できますか?
はい。textDetail (0-2)でテキストの含め方を、cssLevel (0-3)でスタイルの詳細度(CSSなしから完全な計算済みスタイルまで)を制御できます。
MCP Pointerはどのポートを使用しますか?
拡張機能は、ポート7007のWebSocket経由でMCP serverに要素データを送信します。