内容
# 浏览器 MCP 工具包
适用于浏览器研究和交互式自动化的便携式双服务器 MCP 设置。`browse-mcp` 处理搜索、页面读取和内容提取；Playwright MCP 控制一个真正的 Chrome 窗口，用于点击、表单和用户辅助登录。
该仓库仅包含可重用的配置和帮助脚本。浏览器配置文件、cookie、会话数据、下载、截图、日志和本地环境文件已被排除在 Git 之外。
## 功能列表
| 需求 | 服务器 | 功能描述 |
| --- | --- | --- |
| 搜索、读取页面、提取链接和文本 | `browse-mcp` | 面向研究的浏览器访问 |
| 点击、输入、提交表单、使用已登录站点 | Playwright MCP | 控制一个有界面的 Chrome 实例 |
| 多因素身份验证、验证码或交互式登录 | Playwright MCP | 允许您在 Chrome 中手动完成敏感步骤 |
## 快速开始
要求：Node.js 18 或更新版本和一个支持 MCP 的客户端。
```bash
git clone https://github.com/parigihelori352-cyber/browse.git browser-mcp-toolkit
cd browser-mcp-toolkit
npm install
npm run setup
npm run check
npm run mcp:config
```
将 `npm run mcp:config` 输出的 JSON 复制到您的 MCP 客户端配置中。它可以自动发现项目位置，因此无论项目克隆到哪里，它都有效。在 Windows 上，`scripts\show-mcp-config.cmd` 提供相同的输出。
建议使用 `npm run mcp:config`：不要手动编写相对路径，也不要使用从他人机器复制的固定路径。
## 生成的 MCP 配置
帮助程序打印一个完整的配置，相当于以下模板。仅当您选择手动配置时，请替换 `/absolute/path/to/browser-mcp-toolkit`。
```json
{
"mcpServers": {
"browse": {
"command": "node",
"args": ["node_modules/browse-mcp/dist/index.js"],
"cwd": "/absolute/path/to/browser-mcp-toolkit",
"env": { "BROWSE_MCP_EPHEMERAL": "1" }
},
"playwright": {
"command": "node",
"args": [
"node_modules/@playwright/mcp/cli.js",
"--browser=chrome",
"--user-data-dir=/absolute/path/to/browser-mcp-toolkit/profiles/chrome-profile",
"--timeout-action=15000",
"--timeout-navigation=30000",
"--save-session"
],
"cwd": "/absolute/path/to/browser-mcp-toolkit"
}
}
}
```
`browse-mcp` 使用标准输入/输出（stdio），而不是 HTTP 服务器。故意没有 Browse MCP URL，如 `localhost:3002`。
## 使用工具包
您的 MCP 客户端通常从配置中启动服务器。以下命令仅用于本地故障排除：
```bash
npm run browse
npm run playwright
```
在第一次 Playwright 运行中，Chrome 窗口将打开。请手动完成任何登录、多因素身份验证或验证码。其配置文件存储在 `profiles/chrome-profile/` 中，因此后续运行可以重用会话。永远不要提交该目录。
生成的配置中包含 `BROWSE_MCP_EPHEMERAL=1`，以最小化 `browse-mcp` 在项目外部保存的状态。如果您故意需要持久的 Browse MCP 状态，请删除它。
## 版本和兼容性
两个服务器包都被故意固定：`browse-mcp` 固定到 `0.8.2`，`@playwright/mcp` 固定到 `0.0.77`。这使得已知的配置可复制。故意升级它们，运行 `npm install`，运行 `npm run check`，并在发布更新之前验证生成的 MCP 配置。
## 安全
在发布或共享工作副本之前，请阅读 [SECURITY.md](SECURITY.md)。特别是，请检查 `git status --ignored`，并确保没有配置文件或会话数据被暂存。
## 项目结构
```text
config/ 每个 MCP 服务器的参考参数
scripts/show-mcp-config.mjs 跨平台配置生成器
scripts/check.mjs 本地依赖和设置验证
profiles/ 本地创建；被 Git 忽略
```
## 许可证
MIT。参见 [LICENSE](LICENSE)。
