MCP Browser Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Browser ServerNavigate to example.com and take a screenshot"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Browser Server
浏览器自动化 MCP 服务器 - 兼容Claude Code 及其他支持 MCP 协议的工具。
功能特性
提供 30 个浏览器自动化工具:
类别 | 工具 |
导航 |
|
页面信息 |
|
交互 |
|
信息获取 |
|
状态检查 |
|
等待 |
|
标签页 |
|
窗口 |
|
安全 |
|
对话框 |
|
Related MCP server: playwright-mcp-server
安装
cd /home/lpsadmin/work/mcp-cursor-ide-browser
npm install
npm run build工具使用示例
导航操作
打开网页:
browser_navigate(url: "https://example.com")
后退/前进/刷新:
browser_navigate_back()
browser_navigate_forward()
browser_reload()页面交互
点击元素:
browser_click(selector: "button.submit")
输入文字:
browser_type(selector: "input[name='username']", text: "admin")
清空并填入:
browser_fill(selector: "input[name='email']", text: "test@example.com")
批量填表:
browser_fill_form(fields: {
"input[name='username']": "admin",
"input[name='password']": "123456"
})页面信息
获取页面快照(可访问性树):
browser_snapshot()
截图:
browser_take_screenshot(fullPage: true)
页面内搜索:
browser_search(query: "登录")状态检查
检查元素是否可见:
browser_is_visible(selector: ".modal")
检查元素是否启用:
browser_is_enabled(selector: "button.submit")
检查复选框是否勾选:
browser_is_checked(selector: "input[type='checkbox']")标签页管理
列出所有标签页:
browser_tabs(action: "list")
新建标签页:
browser_tabs(action: "new")
切换标签页:
browser_tabs(action: "switch", tabId: 1)
关闭标签页:
browser_tabs(action: "close", tabId: 2)等待操作
等待文字出现:
browser_wait_for(text: "加载完成")
等待文字消失:
browser_wait_for(text: "加载中...", waitForGone: true)
等待指定时间:
browser_wait_for(timeout: 3000)锁定/解锁
锁定浏览器(防止误操作):
browser_lock()
解锁浏览器:
browser_unlock()环境要求
Node.js 16+
支持的操作系统:Linux、macOS、Windows
技术栈
Puppeteer - 浏览器自动化
@modelcontextprotocol/sdk - MCP 协议支持
TypeScript - 类型安全
配置选项
默认使用 Headless 模式运行(无图形界面)。如需可视化模式,可修改 src/browser.ts 中的 headless 选项:
this.browser = await puppeteer.launch({
headless: false, // 改为 false 可启用可视化模式
// ...
});故障排除
1. 浏览器启动失败
错误信息:Missing X server or $DISPLAY
解决方案:确保使用 Headless 模式(默认已启用)。
2. 找不到模块
错误信息:Cannot find module
解决方案:
cd /home/lpsadmin/work/mcp-cursor-ide-browser
npm install
npm run build3. 权限问题
错误信息:EACCES: permission denied
解决方案:
chmod +x /home/lpsadmin/work/mcp-cursor-ide-browser/dist/index.jsLicense
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
AI-powered browser automation — navigate, click, fill forms, and extract data from any website.
Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…
Related MCP Servers
- AlicenseCqualityDmaintenanceA session-based MCP server that provides advanced browser automation capabilities, allowing users to control browsers, navigate websites, interact with elements, capture screenshots, generate PDFs, and manage cookies through natural language.351MIT
- AlicenseNot gradedqualityDmaintenanceA fully local MCP server for browser automation using Playwright, providing 25 tools for navigation, content extraction, mouse, form, and keyboard interactions.1,199 npmMIT
- AlicenseNot gradedqualityDmaintenanceA Selenium-based MCP server that exposes browser automation tools for navigation, interaction, form filling, and assertions, enabling AI agents to control web browsers through natural language.GPL 3.0
- FlicenseNot gradedqualityBmaintenanceStandalone browser automation MCP server supporting both BrowserOS and standard Chrome. Enables 16 MCP tools for browser control including navigation, interaction, and content extraction.6 npm-