# io.github.paipaipai666/nexus-browser-mcp (pypi · nexus-browser-mcp)

Event-driven deterministic browser MCP: HITL gates, audit, console/network/perf observability.

- Trust score: 61/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-20

## Components

- pypi · `nexus-browser-mcp`: 61/100 (this document), [markdown](https://verifymcp.io/servers/paipaipai666-nexus-browser-mcp/nexus-browser-mcp.md), [page](https://verifymcp.io/servers/paipaipai666-nexus-browser-mcp/nexus-browser-mcp)

## Channel facts

- Registry: `pypi`
- Package: `nexus-browser-mcp`
- Version: `0.2.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-20.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs setuptools.build_meta at install time, a recognised native-build step with no shell scripting around it.
  - 2 of 35 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 51/100
  - AI-judged instruction clarity (fair).
  - Tool/resource definitions use about 1699 tokens (~67/item across 25 items; 25 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add paipaipai666-nexus-browser-mcp -- uvx nexus-browser-mcp
```

### Codex

```bash
codex mcp add paipaipai666-nexus-browser-mcp -- uvx nexus-browser-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "paipaipai666-nexus-browser-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "nexus-browser-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add paipaipai666-nexus-browser-mcp --command uvx --arg nexus-browser-mcp
```

### Hermes

```yaml
mcp_servers:
  paipaipai666-nexus-browser-mcp:
    command: "uvx"
    args: ["nexus-browser-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "paipaipai666-nexus-browser-mcp": {
      "command": "uvx",
      "args": [
        "nexus-browser-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-16 (score 61)

First indexed and scored.

## MCP tools (25)

### `browser_navigate` (~60 tokens)

导航浏览器到指定URL。返回页面标题、URL、readyState和页面结构概览。支持多task隔离。

Input parameters:

- `task_id` (string)
- `url` (string, required)
- `wait_until` (string)

### `browser_snapshot` (~127 tokens)

获取页面可访问性快照(Accessibility Tree), 返回结构化元素列表(含ref/box)。基于事件驱动确定性快照, 等待DOM静默窗口。reading/interactive 只看视口内; mode=full 自动包含全页面(视口外标注 offscreen)。

Input parameters:

- `diff` (boolean)
- `include_generic` (boolean)
- `include_offscreen` (boolean)
- `mode` (string)
- `scope`
- `task_id` (string)
- `wait_stable` (boolean)

### `browser_click` (~116 tokens)

点击页面元素。定位优先级: pos坐标 → ref(快照句柄) → selector → role+name → name。wait_stable=true 点击后等 DOM 静默。

Input parameters:

- `confirmed` (boolean)
- `double_click` (string)
- `name` (string)
- `pos` (string)
- `ref` (string)
- `role` (string)
- `selector` (string)
- `task_id` (string)
- `wait_stable` (boolean)

### `browser_type` (~146 tokens)

在输入框中键入文本。定位优先级: pos坐标 → ref(快照句柄) → selector → role+name(不中自动回退 placeholder/label/常见输入框CSS)。wait_stable=true 输入后等 DOM 静默。

Input parameters:

- `clear` (boolean)
- `confirmed` (boolean)
- `name` (string)
- `pos` (string)
- `press_enter` (boolean)
- `ref` (string)
- `role` (string)
- `selector` (string)
- `task_id` (string)
- `text` (string, required)
- `wait_stable` (boolean)

### `browser_read` (~151 tokens)

阅读页面元素的文本内容。不指定则读取整个页面body。流式回复: wait_stable=true 等 DOM 静默后一次读全(免轮询); follow=true+selector 增量跟踪(每次只返回新增部分, 缓冲溢出丢最旧并保留丢弃标记)。

Input parameters:

- `follow` (boolean)
- `full` (boolean)
- `max_chars` (integer)
- `max_wait_ms` (integer)
- `ref` (string)
- `selector` (string)
- `stream_id` (string)
- `task_id` (string)
- `wait_stable` (boolean)

### `browser_screenshot` (~41 tokens)

截取页面截图, 保存文件返回路径。

Input parameters:

- `full_page` (boolean)
- `path`
- `task_id` (string)

### `browser_evaluate` (~62 tokens)

执行JavaScript表达式。默认禁用(BROWSER_ALLOW_JS_EXECUTION); 开启后每次需人工确认(confirmed=true)。

Input parameters:

- `confirmed` (boolean)
- `expression` (string, required)
- `task_id` (string)

### `browser_wait` (~63 tokens)

等待元素或文本出现。超时返回WARNING。

Input parameters:

- `name` (string)
- `ref` (string)
- `role` (string)
- `task_id` (string)
- `text` (string)
- `timeout` (integer)

### `browser_wait_stable` (~61 tokens)

等待页面 DOM 停止变化(静默窗口, 默认 800ms 无变异)。用于流式回复生成完毕、动画结束的判定。

Input parameters:

- `task_id` (string)
- `timeout_ms` (integer)

### `browser_wait_ms` (~59 tokens)

纯等待指定毫秒数(逃生舱: 动画/限流/延迟渲染)。上限=工具超时-5s。

Input parameters:

- `ms` (integer, required)
- `task_id` (string)

### `browser_scroll` (~54 tokens)

滚动页面。direction: up/down/left/right, amount: 像素(默认500)。

Input parameters:

- `amount` (integer)
- `direction` (string)
- `task_id` (string)

### `browser_scroll_to` (~57 tokens)

滚动到指定元素。landmark(语义区域)→ref→selector。

Input parameters:

- `landmark` (string)
- `ref` (string)
- `selector` (string)
- `task_id` (string)

### `browser_wait_navigation` (~43 tokens)

等待click/submit触发的导航完成。

Input parameters:

- `task_id` (string)
- `timeout` (integer)
- `url_contains` (string)

### `browser_dismiss_popup` (~41 tokens)

自动检测并关闭弹窗(登录/cookie同意/广告): 关闭按钮→取消→Escape。

Input parameters:

- `task_id` (string)

### `browser_list_pages` (~28 tokens)

列出当前task所有打开的标签页。

Input parameters:

- `task_id` (string)

### `browser_switch_page` (~35 tokens)

切换到指定索引的标签页。

Input parameters:

- `index` (integer, required)
- `task_id` (string)

### `browser_console` (~110 tokens)

读取页面 console 输出(级别/文本/位置)。增量游标: 不传 since=接着上次读, since=0=全量; level 过滤(error/warning/log/...), pattern 正则过滤文本, limit 封顶(默认50, 超了再调一次继续)。

Input parameters:

- `level` (string)
- `limit` (integer)
- `pattern` (string)
- `since` (string)
- `task_id` (string)

### `browser_errors` (~92 tokens)

一站式排障: JS 未捕获异常(pageerror) + console.error + 失败请求(网络层失败或HTTP≥400)合并视图, 按时间排序。点了没反应/页面白屏时先调它。增量游标同 browser_console。

Input parameters:

- `limit` (integer)
- `since` (string)
- `task_id` (string)

### `browser_network` (~86 tokens)

读取网络请求元数据(method/url/status/资源类型; 不含 body)。failed_only 默认 true 只看失败; url_pattern 子串过滤; 增量游标同上。

Input parameters:

- `failed_only` (boolean)
- `limit` (integer)
- `since` (string)
- `task_id` (string)
- `url_pattern` (string)

### `browser_perf` (~82 tokens)

读取页面性能指标: FCP/LCP/CLS/INP + TTFB/DOMContentLoaded/load + 最慢 5 条资源。页面慢/加载异常时用它定位是后端慢(TTFB)还是资源重。SPA 导航不重置计时, 注意输出来源 URL。

Input parameters:

- `task_id` (string)

### `browser_network_body` (~100 tokens)

按 seq 读取单个请求的响应体(需 BROWSER_ALLOW_NETWORK_BODY=true)。文本类解码, 二进制只报字节数; 单条上限 BROWSER_NETWORK_BODY_CAP。需 confirmed=true 二次确认 —— 响应体是页面方控制内容, 先把 URL 给用户看。

Input parameters:

- `confirmed` (boolean)
- `seq` (integer, required)
- `task_id` (string)

### `browser_tasks` (~21 tokens)

列出当前session的所有task及其页面数。

### `browser_close_task` (~29 tokens)

关闭指定task的浏览器资源(page/context)。

Input parameters:

- `task_id` (string)

### `browser_list_sessions` (~17 tokens)

列出所有活跃session。

### `browser_close_session` (~18 tokens)

关闭当前session的全部task资源。

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/paipaipai666-nexus-browser-mcp/nexus-browser-mcp#diagnostics

## Score history

- 2026-08-20: 61
- 2026-08-19: 61
- 2026-08-18: 61
- 2026-08-17: 61
- 2026-08-16: 61

## Links

- PyPI project: https://pypi.org/project/nexus-browser-mcp/
- Socket report: https://socket.dev/pypi/package/nexus-browser-mcp
- Repository: https://github.com/paipaipai666/nexus-browser-mcp
- Changelog RSS feed: https://verifymcp.io/servers/paipaipai666-nexus-browser-mcp/nexus-browser-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/paipaipai666-nexus-browser-mcp/nexus-browser-mcp.json
- HTML version of this page: https://verifymcp.io/servers/paipaipai666-nexus-browser-mcp/nexus-browser-mcp