# Nabo MCP Lite

一个精简的本地 MCP 浏览器控制桥接项目。它保留 Nanobrowser 操作 Chrome 网页所需的核心能力，移除了模型、Agent 编排、语音、界面和遥测等非必要模块。

## 架构

```text
MCP Client（Claude / Codex / 其他客户端）
                 │ stdio MCP
                 ▼
server/single-session-server.cjs
                 │ WebSocket 127.0.0.1:9876
                 ▼
Nabo MCP Lite Chrome Extension
                 │ Chrome API / CDP
                 ▼
Chrome 网页标签页
```

## 功能

提供 14 个 MCP 工具：

- 标签页：`list_tabs`、`switch_tab`、`open_tab`、`close_tab`
- 导航：`navigate`
- 页面读取：`get_dom`、`get_page_text`、`screenshot`
- 页面操作：`click_element`、`input_text`、`select_option`
- 键盘和滚动：`send_keys`、`scroll`
- 脚本执行：`execute_script`

`get_page_text` 最多返回 50,000 字符，并提供 `truncated` 和 `originalLength`，避免大型网页占满 Agent 上下文。

## 环境要求

- Node.js 18+
- pnpm
- Google Chrome
- 支持 stdio MCP 的客户端

## 安装与构建

```powershell
git clone https://github.com/kaleburannengsha-hue/nabo-mcp-lite.git
cd nabo-mcp-lite
pnpm install
pnpm test
pnpm type-check
pnpm build
```

构建产物位于 `dist/`。

## 加载 Chrome 扩展

1. 打开 `chrome://extensions`。
2. 开启“开发者模式”。
3. 点击“加载已解压的扩展程序”。
4. 选择项目的 `dist` 目录。
5. 每次重新构建后，点击扩展卡片上的刷新按钮。

## MCP 配置

Claude Desktop 示例见：

```text
config/claude-desktop.example.json
```

核心配置：

```json
{
  "mcpServers": {
    "nanobrowser": {
      "command": "node",
      "args": [
        "D:\\path\\to\\nabo-mcp-lite\\server\\single-session-server.cjs"
      ]
    }
  }
}
```

Claude Code：

```powershell
claude mcp add nanobrowser -- node D:\path\to\nabo-mcp-lite\server\single-session-server.cjs
```

其他客户端可参考 `config/mcp-stdio.example.json`。

## 测试真实连接

确保 Chrome 已加载并刷新扩展，且没有其他进程占用 9876：

```powershell
$env:IDLE_WAIT_MS = "2000"
node scripts/runtime-test.cjs
```

成功输出应包含：

```text
FIRST_CALL_OK
DOM_OK
PAGE_TEXT_OK
SECOND_CALL_OK
RUNTIME_TEST_OK
```

## 使用限制

- 当前为单 Session 服务，同一时间只能有一个服务端监听 9876。
- 多个 MCP 客户端同时启动服务端会产生端口冲突。
- `chrome://` 内部页面受 Chrome 安全策略限制。
- `execute_script` 可以执行网页脚本，只应连接可信的本地 MCP 客户端。

## 文档

- [完整操作指引](OPERATIONS.md)
- [当前项目状态](STATUS.md)
- [配置示例](config)

## 来源与许可证

浏览器控制层基于 [Nanobrowser](https://github.com/nanobrowser/nanobrowser) 精简和修改。

项目按 Apache License 2.0 发布，详见 `LICENSE` 和 `NOTICE`。