neo-vision

maps-geo MCP Server

See the web the way Neo sees the Matrix. Spatial DOM mapping MCP server for AI agents — pixel-precise coordinates, ARIA roles, and anti-bot stealth that beats Ticketmaster, Nike, LinkedIn, Instagram, Amazon & Discord.

VerifiedInstall Ready
maps-geomaps-geo
3 views1 stars0 forksv0.6.0MIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 4mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
1
Last synced
4mo ago
Install
Instructions detected

Install

1. Install the package

npx neo-vision

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "neo-vision": {
      "command": "npx",
      "args": [
        "neo-vision"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

17
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (17)

Tool

Description

spatial_screenshot

Capture a PNG screenshot of the current page as base64-encoded data.

spatial_pace

Human-like pacing manager for multi-page scraping sessions. Manages randomized delays, periodic breaks, CAPTCHA detection, and automatic slowdown. Prevents anti-bot pattern detection across long scraping runs.

spatial_snapshot

Navigate to a URL and return a spatial DOM map with element coordinates, ARIA roles, and actionability flags. Supports `compact` and `agent` output formats. Now CSP-safe — works on x.com, GitHub, banks, and other strict-CSP sites.

spatial_navigate

Load a URL without capturing a snapshot — lighter-weight than `spatial_snapshot` when you just need to navigate.

spatial_scroll

Scroll the page or a specific scrollable container. Returns updated spatial map.

spatial_get_window_geometry

Returns Chrome's screen position, chrome-bar height, current scroll offset, and devicePixelRatio. Used internally by `spatial_click` / `spatial_type` to translate page CSS coords → screen pixels for OS-level dispatch. Exposed for debugging coordinate translation.

spatial_import_cookies

Import cookies into the browser session. Use to warm up sessions with cookies from the user's real browser for anti-bot bypass.

spatial_query

Filter the cached spatial map by ARIA role, HTML tag, label text, bounding box region, or actionability — without reloading the page.

spatial_export_cookies

Export cookies from the current browser session. Optionally filter by domain.

spatial_type

**Real OS-level keystrokes** via cliclick. Per-keystroke 60–180ms delays + occasional thinking pauses on word boundaries. `event.isTrusted = true`. Auto-focuses the field by clicking it first if `x`/`y` given. Requires `brew install cliclick`.

spatial_execute_js

Run arbitrary JavaScript in the page. Defaults to `world: 'isolated'` (the extension's content-script context — bypasses page CSP, full DOM access, no page-world variable access). Pass `world: 'main'` for the legacy MAIN-world behavior (page-world vars accessible but breaks on CSP-strict sites).

spatial_disconnect_cdp

Release the CDP connection. The user's Chrome stays open.

spatial_click

**Real OS-level mouse click** via cliclick (CGEvent, `event.isTrusted = true`). Cursor visibly travels to the target with eased animation; ±3px coord jitter; post-arrival pause. Defeats `isTrusted`-based anti-bot detection. Pass `synthetic: true` for the legacy in-page MouseEvent dispatch (only for edge cases). Requires `brew install cliclick`.

spatial_wait

Pause execution for a specified duration. Use for pacing between page navigations.

spatial_connect_cdp

Connect to the user's real Chrome browser via Chrome DevTools Protocol. NeoVision automatically relaunches Chrome with CDP enabled if needed. All spatial tools then operate on the real browser session.

spatial_get_injectable

Get the NeoVision snapshot logic as injectable JavaScript for external browser contexts. Returns a self-invoking script, an installer, or raw source.