[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73742":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":16,"starSnapshotCount":16,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},73742,"mcp-server-browserbase","browserbase\u002Fmcp-server-browserbase","browserbase","Allow LLMs to control a browser with Browserbase and Stagehand","https:\u002F\u002Fstagehand.dev",null,"TypeScript",3368,358,25,32,0,3,5,37,9,71.87,"Apache License 2.0",false,"main",true,[27,28,29,30,31,32,33],"ai","browser","chrome","chromium","mcp","playwright","puppeteer","2026-06-12 04:01:11","# Browserbase MCP Server\n\n![cover](assets\u002Fcover.png)\n\n[The Model Context Protocol (MCP)](https:\u002F\u002Fmodelcontextprotocol.io\u002Fintroduction) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.\n\nThis server provides cloud browser automation capabilities using [Browserbase](https:\u002F\u002Fwww.browserbase.com\u002F) and [Stagehand](https:\u002F\u002Fgithub.com\u002Fbrowserbase\u002Fstagehand). It enables LLMs to interact with web pages, extract information, and perform automated actions.\n\nThis is a self-hostable version of the [Browserbase hosted MCP server](https:\u002F\u002Fmcp.browserbase.com\u002Fmcp) with the same tools and functionality. **We recommend using the hosted version for the easiest setup.**\n\n## Tools\n\nThis server exposes 6 tools that match the [hosted Browserbase MCP server](https:\u002F\u002Fdocs.browserbase.com\u002Fintegrations\u002Fmcp\u002Fintroduction):\n\n| Tool       | Description                             | Input                      |\n| ---------- | --------------------------------------- | -------------------------- |\n| `start`    | Create or reuse a Browserbase session   | _(none)_                   |\n| `end`      | Close the current Browserbase session   | _(none)_                   |\n| `navigate` | Navigate to a URL                       | `{ url: string }`          |\n| `act`      | Perform an action on the page           | `{ action: string }`       |\n| `observe`  | Observe actionable elements on the page | `{ instruction: string }`  |\n| `extract`  | Extract data from the page              | `{ instruction?: string }` |\n\n## How to Setup\n\nWe currently support 2 transports for our MCP server, STDIO and SHTTP. We recommend you use SHTTP with our hosted MCP server to take advantage of the server at full capacity.\n\n## SHTTP (Hosted MCP):\n\nUse the Browserbase hosted MCP server at `https:\u002F\u002Fmcp.browserbase.com\u002Fmcp`. This is the easiest way to get started -- we host the server and provide the LLM costs for Gemini, the [best performing model](https:\u002F\u002Fwww.stagehand.dev\u002Fevals) in [Stagehand](https:\u002F\u002Fwww.stagehand.dev).\n\nFor full setup instructions, see the [Browserbase MCP documentation](https:\u002F\u002Fdocs.browserbase.com\u002Fintegrations\u002Fmcp\u002Fintroduction).\n\nIf your client supports SHTTP:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Fmcp.browserbase.com\u002Fmcp\"\n    }\n  }\n}\n```\n\nIf your client doesn't support SHTTP:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-remote\", \"https:\u002F\u002Fmcp.browserbase.com\u002Fmcp\"]\n    }\n  }\n}\n```\n\n## STDIO (Self-Hosted):\n\nYou can either use our server hosted on NPM or run it completely locally by cloning this repo.\n\n> **Note:** If you want to use a different model you have to add --modelName to the args and provide that respective key as an arg. More info below.\n\n### To run via NPM (Recommended)\n\nGo into your MCP Config JSON and add the Browserbase Server:\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\"@browserbasehq\u002Fmcp\"],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\nThat's it! Reload your MCP client and you're ready to go.\n\n### To run 100% local:\n\n#### Option 1: Direct installation\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fbrowserbase\u002Fmcp-server-browserbase.git\ncd mcp-server-browserbase\nnpm install && npm run build\n```\n\n#### Option 2: Docker\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fbrowserbase\u002Fmcp-server-browserbase.git\ncd mcp-server-browserbase\ndocker build -t mcp-browserbase .\n```\n\nThen in your MCP Config JSON run the server:\n\n#### Using Direct Installation\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"node\",\n      \"args\": [\"\u002Fpath\u002Fto\u002Fmcp-server-browserbase\u002Fcli.js\"],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n#### Using Docker\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"-e\",\n        \"BROWSERBASE_API_KEY\",\n        \"-e\",\n        \"BROWSERBASE_PROJECT_ID\",\n        \"-e\",\n        \"GEMINI_API_KEY\",\n        \"mcp-browserbase\"\n      ],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\",\n        \"GEMINI_API_KEY\": \"\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\nThe Browserbase MCP server accepts the following command-line flags:\n\n| Flag                       | Description                                                                 |\n| -------------------------- | --------------------------------------------------------------------------- |\n| `--proxies`                | Enable Browserbase proxies for the session                                  |\n| `--verified`               | Enable Browserbase Verified Identity (Only for Scale Plan Users)            |\n| `--advancedStealth`        | Deprecated alias for `--verified`                                           |\n| `--keepAlive`              | Enable Browserbase Keep Alive Session                                       |\n| `--contextId \u003CcontextId>`  | Specify a Browserbase Context ID to use                                     |\n| `--persist`                | Whether to persist the Browserbase context (default: true)                  |\n| `--port \u003Cport>`            | Port to listen on for HTTP\u002FSHTTP transport                                  |\n| `--host \u003Chost>`            | Host to bind server to (default: localhost, use 0.0.0.0 for all interfaces) |\n| `--browserWidth \u003Cwidth>`   | Browser viewport width (default: 1024)                                      |\n| `--browserHeight \u003Cheight>` | Browser viewport height (default: 768)                                      |\n| `--modelName \u003Cmodel>`      | The model to use for Stagehand (default: google\u002Fgemini-2.5-flash-lite)      |\n| `--modelApiKey \u003Ckey>`      | API key for the custom model provider (required when using custom models)   |\n| `--experimental`           | Enable experimental features (default: false)                               |\n\nThese flags can be passed directly to the CLI or configured in your MCP configuration file.\n\n> **Note:** These flags can only be used with the self-hosted server (npx @browserbasehq\u002Fmcp or Docker).\n\n### Model Configuration\n\nStagehand defaults to using Google's Gemini 2.5 Flash Lite model, but you can configure it to use other models like GPT-4o, Claude, or other providers.\n\n**Important**: When using any custom model (non-default), you must provide your own API key for that model provider using the `--modelApiKey` flag.\n\n```json\n{\n  \"mcpServers\": {\n    \"browserbase\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@browserbasehq\u002Fmcp\",\n        \"--modelName\",\n        \"anthropic\u002Fclaude-sonnet-4.5\",\n        \"--modelApiKey\",\n        \"your-anthropic-api-key\"\n      ],\n      \"env\": {\n        \"BROWSERBASE_API_KEY\": \"\",\n        \"BROWSERBASE_PROJECT_ID\": \"\"\n      }\n    }\n  }\n}\n```\n\n_Note: The model must be supported in Stagehand. Check out the docs [here](https:\u002F\u002Fdocs.stagehand.dev\u002Fexamples\u002Fcustom_llms#supported-llms)._\n\n## Links\n\n- [Browserbase MCP Documentation](https:\u002F\u002Fdocs.browserbase.com\u002Fintegrations\u002Fmcp\u002Fintroduction)\n- [MCP Documentation](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs)\n- [MCP Specification](https:\u002F\u002Fspec.modelcontextprotocol.io\u002F)\n- [Stagehand Documentation](https:\u002F\u002Fdocs.stagehand.dev\u002F)\n\n## License\n\nLicensed under the Apache 2.0 License.\n\nCopyright 2025 Browserbase, Inc.\n","Browserbase MCP Server 是一个允许大型语言模型（LLM）通过 Browserbase 和 Stagehand 控制浏览器的项目。其核心功能包括创建或重用浏览器会话、导航至指定URL、执行页面操作、观察页面元素以及从页面中提取数据，这些功能均通过六个工具实现。该项目使用 TypeScript 编写，并支持 STDIO 和 SHTTP 两种传输方式，适用于需要将 LLM 与外部数据源和工具无缝集成的场景，如构建基于 AI 的 IDE、增强聊天界面或自定义 AI 工作流。此外，它提供了一个可自行托管的版本，但推荐使用官方托管的服务以简化设置过程。",2,"2026-06-11 03:47:10","high_star"]