BrowserForce MCP 服务器
<Markdown>
- 项目概览
- 该仓库提供基于 MCP 的 BrowserForce 服务器端实现，核心职责是为 MCP 客户端提供标准化的资源访问、工具执行能力以及对 Prompt/模板等的渲染与管理。通过一个本地 Relay 与 Chrome/扩展实现进行无缝协作，允许 LLM 在你的真实浏览器环境中执行任务并获取上下文信息。
- 主要功能点
- MCP 服务器核心实现：接收、处理 MCP 请求，返回 JSON-RPC 风格的响应，支持会话、工具执行、任务调度等能力。
- 工具与会话：提供 execute（在真实浏览器中执行 Playwright 代码）以及 reset（重新建立连接/重置上下文）的工具对接，供 MCP 客户端调用。
- 插件体系：支持插件加载与扩展，插件可以注入额外的工具、技能描述等，提升执行能力与可扩展性。
- 与浏览器的对接：通过本地 Relay 将 MCP 请求转译为对 Chrome/扩展的实际操作，并实现对浏览器标签页、CDP 会话等的管理。
- 安全与会话管理：实现对会话、权限、并发客户端的控制与保护，确保在本地环境中安全运行。
- 安装与运行
- 先在服务器端部署依赖并安装必要组件；再启动本地 Relay 服务与 MCP 服务。
- 运行步骤通常包括两步：启动 Relay（browserforce serve），随后启动 MCP 服务（browserforce mcp）。
- 服务器配置（MCP 客户端配置示例，json 格式）
- 注意：下面的配置示例用于 MCP 客户端连接到 BrowserForce MCP 服务器。具体参数请根据你的环境调整，JSON 不含代码块注释，括注释以自然语言说明为辅。
- 常见示例（多客户端模式）：
{
"mcpServers": {
"browserforce": {
"name": "browserforce",
"command": "npx",
"args": ["-y", "browserforce@latest", "mcp"]
}
}
}
- 兼容 Windows 的一行类似启动（可选，若需通过 env 变量控制行为）：
{
"mcpServers": {
"browserforce": {
"command": "env",
"args": ["BF_CLIENT_MODE=multi-client", "npx", "-y", "browserforce@latest", "mcp"]
}
}
}
- 说明与注意
- server name 表示 MCP 客户端将要连接的服务器名称，command/args 指定启动 MCP 服务的具体命令与参数。
- 该配置是给 MCP 客户端使用的，客户端并不需要了解服务器内部实现细节，仅需要知道如何启动并连接到 MCP 服务器。
</Markdown>