内容
# SpidexLab的多租户浏览器MCP 🚀
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://developer.chrome.com/docs/extensions/)
> 🌟 **SpidexLab为自主代理定制的版本** - 这是Chrome MCP服务器的修改版本，特别重新架构以支持 **多租户标签多路复用** 和 **并发代理** 。
>
> *这是一个专门的分支。有关原始上游项目，请访问 [hangwin/mcp-chrome](https://github.com/hangwin/mcp-chrome)。*
**📖 文档**: [中文](README.md)
---
## 🎯 这个分支有什么不同？
原始的Chrome MCP服务器是一个非常强大的工具，它向AI助手公开了Chrome浏览器功能。然而，它是在1到1的连接限制下构建的（一个代理控制一个浏览器会话）。
**SpidexLab的修改（V3：乘数）：**
我们修改了本地服务器桥接逻辑和扩展消息架构，以支持多租户执行队列。这允许 **多个自主AI代理同时连接到同一个浏览器实例** 。每个代理在其自己的隔离浏览器标签上下文中运行，允许多个代理并行执行网页研究和自动化任务，而不会出现连接重置或状态冲突。
## ✨ 核心功能
- 👯 **多租户标签多路复用**: 并发代理可以在隔离的标签上下文中同时运行。
- 😁 **聊天机器人/模型无关**: 让您喜欢的任何LLM或聊天机器人客户端或代理自动执行您的浏览器
- ⭐️ **使用您的原始浏览器**: 与现有的浏览器环境（您的配置、登录状态等）无缝集成
- 💻 **完全本地**: 纯本地MCP服务器，确保用户隐私
- 🚄 **可流式HTTP**: 可流式HTTP连接方法
- 🏎 **跨标签**: 跨标签上下文
- 🧠 **语义搜索**: 用于智能浏览器标签内容发现的内置向量数据库
- 🔍 **智能内容分析**: AI驱动的文本提取和相似性匹配
- 🌐 **20+工具**: 支持截图、网络监控、交互式操作、书签管理、浏览历史等20多种工具
## 🚀 快速开始
### 先决条件
- Node.js >= 20.0.0 和 pnpm/npm
- Chrome/Chromium 浏览器
### 安装步骤
1. **从GitHub下载最新的Chrome扩展程序**
从此存储库的 `releases/` 文件夹中下载 `chrome-mcp-server-latest.zip`。
2. **全局安装mcp-chrome-bridge**
```bash
npm install -g mcp-chrome-bridge
```
3. **加载Chrome扩展程序**
- 打开Chrome并转到 `chrome://extensions/`
- 启用“开发者模式”
- 点击“加载解压的扩展程序”并选择解压的扩展程序文件夹
- 点击扩展程序图标打开插件，然后点击连接查看MCP配置。
### 与MCP协议客户端一起使用
#### 使用可流式HTTP连接（👍🏻 推荐）
在您的MCP客户端配置中添加以下配置：
```json
{
"mcpServers": {
"chrome-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:12306/mcp"
}
}
}
```
## 🛠️ 可用工具
完整工具列表： [完整工具列表](docs/TOOLS.md)
<details>
<summary><strong>📊 浏览器管理（6种工具）</strong></summary>
- `get_windows_and_tabs` - 列出所有浏览器窗口和标签页
- `chrome_navigate` - 导航到URL并控制视口
- `chrome_switch_tab` - 切换当前活动标签页
- `chrome_close_tabs` - 关闭特定的标签页或窗口
- `chrome_go_back_or_forward` - 浏览器导航控制
- `chrome_inject_script` - 将内容脚本注入网页
- `chrome_send_command_to_inject_script` - 向注入的内容脚本发送命令
</details>
<details>
<summary><strong>📸 截图和视觉（1种工具）</strong></summary>
- `chrome_screenshot` - 高级截图，支持元素定位、全页截图和自定义尺寸
</details>
<details>
<summary><strong>🌐 网络监控（4种工具）</strong></summary>
- `chrome_network_capture_start/stop` - webRequest API网络捕获
- `chrome_network_debugger_start/stop` - 带有响应体的调试器API
- `chrome_network_request` - 发送自定义HTTP请求
</details>
<details>
<summary><strong>🔍 内容分析（4种工具）</strong></summary>
- `search_tabs_content` - 跨浏览器标签页的AI驱动语义搜索
- `chrome_get_web_content` - 从页面提取HTML/文本内容
- `chrome_get_interactive_elements` - 查找可点击元素
- `chrome_console` - 从浏览器标签页捕获和检索控制台输出
</details>
<details>
<summary><strong>🎯 交互（3种工具）</strong></summary>
- `chrome_click_element` - 使用CSS选择器点击元素
- `chrome_fill_or_select` - 填写表单和选择选项
- `chrome_keyboard` - 模拟键盘输入和快捷键
</details>
<details>
<summary><strong>📚 数据管理（5种工具）</strong></summary>
- `chrome_history` - 搜索带有时间筛选器的浏览器历史记录
- `chrome_bookmark_search` - 按关键词查找书签
- `chrome_bookmark_add` - 添加带有文件夹支持的新书签
- `chrome_bookmark_delete` - 删除书签
</details>
## 📄 许可证
该项目根据MIT许可证授权 - 有关详细信息，请参见 [LICENSE](LICENSE) 文件。基于原始的 [hangwin/mcp-chrome](https://github.com/hangwin/mcp-chrome) 存储库。
## 📚 更多文档
- [架构设计](docs/ARCHITECTURE.md) - 详细的架构设计文档
- [工具API](docs/TOOLS.md) - 完整的工具API文档
- [故障排除](docs/TROUBLESHOOTING.md) - 常见的解决方案
