内容
# neko-browser
专为 [neko-gundan](https://github.com/aliksir/neko-gundan) 代理设计的专用浏览器 MCP 服务器。采用带有持久化配置文件的 Playwright，完全隔离于日常使用的 Chrome。
## 功能特点
- **持久化配置文件**: 会话在重启后仍然存续（保留 cookie、localStorage、登录状态）
- **有界面模式**: 默认情况下 GUI 可见，用于调试和人工监督
- **23 种 MCP 工具**: 完整的浏览器自动化工具包
- **个人敏感信息屏蔽**: 在响应中自动屏蔽敏感数据（信用卡、社保号码、电子邮件）
- **进程隔离**: 运行其自己的 Chromium 实例，并使用专用的配置文件目录
- **自定义图标**: 注入 Shigoto-neko 图标，便于识别
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `neko_navigate` | 导航到 URL，可选在新标签页中 |
| `neko_click` | 按索引或坐标点击元素 |
| `neko_type` | 在元素中输入文本（键盘事件） |
| `neko_fill` | 通过 DOM 设置文本（用于 contentEditable） |
| `neko_press_key` | 发送键盘按键（Enter、Tab 等） |
| `neko_get_state` | 获取页面 URL、标题、交互式元素 |
| `neko_screenshot` | 捕获页面截图 |
| `neko_scroll` | 滚动页面上下 |
| `neko_go_back` | 在历史记录中导航返回 |
| `neko_get_html` | 获取页面或元素的 HTML |
| `neko_list_tabs` | 列出所有打开的标签页 |
| `neko_switch_tab` | 按 ID 切换到标签页 |
| `neko_close_tab` | 按 ID 关闭标签页 |
| `neko_close` | 关闭浏览器 |
| `neko_upload_file` | 上传文件（直接输入或对话框模式） |
| `neko_evaluate` | 在页面上下文中执行 JavaScript |
| `neko_select` | 选择下拉选项（按值/标签/索引） |
| `neko_wait_for` | 等待选择器状态或导航 |
| `neko_handle_dialog` | 配置 alert/confirm/prompt 处理 |
| `neko_hover` | 悬停在元素上（工具提示、菜单） |
| `neko_check` | 选中/取消选中复选框或单选按钮 |
| `neko_double_click` | 双击元素 |
| `neko_get_attribute` | 获取元素属性 |
## 安装
```bash
npm install
npm run build
```
## 配置
环境变量:
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `NEKO_BROWSER_PROFILE` | `~/.neko-browser/profile` | 配置文件目录路径 |
| `NEKO_BROWSER_HEADLESS` | `false` | 设置为 `true` 以启用无界面模式 |
## 使用（MCP）
添加到您的 Claude Code MCP 设置:
```json
{
"mcpServers": {
"neko-browser": {
"command": "node",
"args": ["dist/index.js"],
"cwd": "/path/to/neko-browser"
}
}
}
```
## License
MIT
