Nstbrowser Playwright MCP

nstbrowser剧作家mcp

MCP服务器，结合 Nst浏览器 配置文件管理 剧作家 通过CDP（Chrome DevTools协议）实现浏览器自动化。

建立在官方之上 @playwright/mcp 软件包——所有浏览器自动化工具都由微软的Playwright MCP服务器提供，通过CDP连接到NSTBrowser配置文件。

特性

• 26个MCP工具 --20个浏览器自动化工具（来自 @playwright/mcp)+6个会话/配置文件管理工具
• 连接到现有的NSTBrowser配置文件或创建临时配置文件
• 具有会话切换功能的多会话支持
• Playwright浏览器完全自动化：导航、点击、打字、截图、JavaScript评估、拖放、表单填写等
• 控制台日志和网络请求跟踪
• AI驱动交互的可访问性快照

先决条件

• >= 20
• Nst浏览器 已安装并正在运行
• NSTBrowser API密钥

快速开始

克劳德代码

claude mcp add nstbrowser -- npx -y nstbrowser-playwright-mcp

然后在环境中设置API密钥或通过 --env:

claude mcp add nstbrowser -e NSTBROWSER_API_KEY=your-api-key-here -- npx -y nstbrowser-playwright-mcp

克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "nstbrowser": {
      "command": "npx",
      "args": ["-y", "nstbrowser-playwright-mcp"],
      "env": {
        "NSTBROWSER_API_KEY": "your-api-key-here"
      }
    }
  }
}

光标/风帆

添加到MCP设置(.cursor/mcp.json 或Windsurf同等产品）：

{
  "mcpServers": {
    "nstbrowser": {
      "command": "npx",
      "args": ["-y", "nstbrowser-playwright-mcp"],
      "env": {
        "NSTBROWSER_API_KEY": "your-api-key-here"
      }
    }
  }
}

从源码安装

git clone https://github.com/jackie099/nstbrowser-playwright-mcp.git
cd nstbrowser-playwright-mcp
npm install
npm run build

配置

环境变量

可用工具

会话管理

浏览器自动化（来自 @playwright/mcp)

创建第一个会话后，这些工具将自动可用。它们由官方Playwright MCP服务器提供，并使用可访问性快照参考(element/ref)针对元素。

NSTBrowser管理

create_session 参数

所有参数都是可选的。当否 profileId 创建临时配置文件。NSTBrowser API对任何省略的字段应用合理的默认值（请参见 Nstbrower API文档 详细信息）。

用法示例

连接到现有配置文件

Use create_session with profileId "abc123" to connect to my NSTBrowser profile,
then navigate to https://example.com and take a screenshot.

创建临时会话（不需要参数）

Create a temporary browser session and navigate to https://news.ycombinator.com.
Get an accessibility snapshot of the page.

使用自定义设置创建临时会话

Create a session with platform "windows" and kernelMilestone "132",
then navigate to https://example.com.

多会话工作流

Create two sessions - one for GitHub and one for Gmail.
Switch between them to check notifications on both.

运作原理

1. 会话创建 --当你打电话的时候 create_session，服务器连接到NSTBrowser的API以获取请求配置文件的CDP（Chrome DevTools协议）WebSocket URL。
2. 剧作家MCP桥 --CDP端点传递给 @playwright/mcps createConnection，它创建了一个连接到该浏览器的完整Playwright MCP服务器实例。
3. 工具代理 --在第一次会话创建时，浏览器工具从Playwright MCP实例中发现，并在我们的服务器上注册为代理工具。工具调用被转发到活动会话的Playwright MCP客户端。
4. 多会话 --每个会话都有自己的Playwright MCP连接。切换会话将所有浏览器工具调用路由到新的活动会话。

发展

npm install
npm run build
npm test
npm run lint

许可证

麻省理工学院