内容
# @bytesbrains/mcp-textbrowser
[](https://www.npmjs.com/package/@bytesbrains/mcp-textbrowser)
[](./LICENSE)
[](https://github.com/bytesbrains/mcp-textbrowser/actions/workflows/ci.yml)
> MCP 服务器 — 以文本为优先的无头浏览器，适用于 Claude Code 和任何 MCP 主机。<br>
> DOM + OCR 文本映射。<span style="font-family: 'Courier New', monospace">**默认零图像令牌**</span>。<span style="font-family: 'Courier New', monospace">**比基于截图的浏览器 MCP 便宜 5-15 倍**</span>。
```
browser_navigate(url) → DOM 元素 + OCR 文本 (~200 令牌)
browser_navigate(url, visual=true) → 文本 + PNG (仅用于布局/颜色)
```
## 为什么
每个基于截图的浏览器 MCP 都会在每次操作时向 AI 发送 PNG。对于 1280×800 的页面，这大约需要 ~1,300 个图像令牌 — 比读取相同内容作为文本贵 5-15 倍。
`mcp-textbrowser` 捕获截图进行 OCR，提取文本，然后 **丢弃图像**。只有结构化的 DOM 元素和 OCR 文本才会到达模型。只有在真正需要像素时（布局检查、颜色、设计审查）才切换到 `visual=true`。
| 模式 | 每次操作的令牌 | 使用场景 |
|---|---|---|
| 纯文本（默认） | ~150–400 | 所有场景：导航、表单、数据提取、工作流程 |
| `visual=true` | ~1,500–3,000 | 布局、颜色、CSS、设计审查 |
## 安装
**步骤 1 — 安装 Chromium** （一次性，~130MB）：
```bash
npx playwright install chromium
```
**步骤 2 — 添加 MCP 服务器：**
### Claude Code (CLI) — 一个命令
```bash
claude mcp add textbrowser -- npx -y @bytesbrains/mcp-textbrowser
```
就这样。重启 Claude Code 后，工具即可准备就绪。
### Claude 桌面版
将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json` （Mac）或 `%APPDATA%\Claude\claude_desktop_config.json` （Windows）：
```json
{
"mcpServers": {
"textbrowser": {
"command": "npx",
"args": ["-y", "@bytesbrains/mcp-textbrowser"]
}
}
}
```
重启 Claude 桌面版。
### 手动安装（任何 MCP 主机）
在主机 MCP 服务器配置中使用 `command: npx`，`args: ["-y", "@bytesbrains/mcp-textbrowser"]`。
## 工具
| 工具 | 功能 |
|---|---|
| `browser_navigate` | 打开 URL，返回页面上下文 |
| `browser_click` | 通过 CSS 选择器 / XPath / 可见文本点击 |
| `browser_type` | 填写输入字段 |
| `browser_scroll` | 滚动页面或元素到视图中 |
| `browser_screenshot` | 捕获当前页面上下文 |
| `browser_read` | 读取当前页面而不导航 |
| `browser_evaluate` | 在页面上运行 JS（仅限安全 DOM 操作） |
所有工具默认 **纯文本** — 将 `visual: true` 传递给任何工具以接收 PNG。
## 示例输出
```
页面：https://example.com/
标题：示例域名
视口：1280x800
元素（3 个交互式，共 14 个）：
[1] <a> href="https://iana.org/domains/example" bbox=(133,175,254,195)
文本： "更多信息..."
OCR（完整页面截图）：
示例域名
此域名用于文档中的示例。
您可以在未经事先协调或请求许可的情况下在文献中使用此域名。
```
## 要求
- Node.js 18+
- Chromium：`npx playwright install chromium` （一次性，~130MB）
## 许可证
MIT © [BytesBrains](https://bytesbrains.io)
---
*为代理人构建，供代理人使用 🤖*
---
由 [BytesBrains](https://bytesbrains.com) 构建和维护 — AI 自动化和代理，工程化生产标准。
*模型提出，代码保证。*
