{"_id":"@ricardochen1996/browser-use-mcp","_rev":"7-35220de81f4422288b81df1a6b12030c","name":"@ricardochen1996/browser-use-mcp","dist-tags":{"latest":"0.1.5"},"versions":{"0.0.0-stage":{"name":"@ricardochen1996/browser-use-mcp","version":"0.0.0-stage","_id":"@ricardochen1996/browser-use-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"dist":{"shasum":"928ac306e4fe906e12f2e2f19d77d0549bd65755","tarball":"https://registry.npmjs.org/@ricardochen1996/browser-use-mcp/-/browser-use-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-SkqcT+Wnc2FixeJyb6V79jjboT5AvgZoqt7eV+65GlANVYvK7t4tpdZzEOvYB5IjVOHLd28KrhnrjF7MY5aSJg==","signatures":[{"sig":"MEUCIHC7LydGNCO5KHN5rB4Q7pIA7x3B9kmhkEHDLZhNIFz1AiEAmCU7l0owP4KAjKytEamA9bprerqU5bT9A9JY05uhUpc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":354},"_npmUser":{"name":"ricardochen1996","email":"chenweitech@qq.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@ricardochen1996/browser-use-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","browser","browser-use","browser-automation","cdp","jev","agent"],"license":"MIT","_id":"@ricardochen1996/browser-use-mcp@0.1.0","maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"homepage":"https://github.com/ricardochen1996/browser-use-mcp#readme","bugs":{"url":"https://github.com/ricardochen1996/browser-use-mcp/issues"},"bin":{"browser-use-mcp":"bin/browser-use-mcp.mjs"},"dist":{"shasum":"6cf4dae2e1d01db1940218b47f020103ebdaea32","tarball":"https://registry.npmjs.org/@ricardochen1996/browser-use-mcp/-/browser-use-mcp-0.1.0.tgz","fileCount":28,"integrity":"sha512-1qiwKCZSfqOISdrOuHTGXxecZadf49mikquOxn8F+AJlih/36fWs6KmKMHO5s6cRSx+7hch7c/mPquyExLo/VQ==","signatures":[{"sig":"MEUCIQD3EAK2zXBspifl+xiwJYUMmotn509ES1J9VZxF0Xb5uwIgDa1/Wwebr0LRRPoV5Cod1Y2hLjduwtyI01K1ntvQMSw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEb6XRmksTwMoF07cwvVkQUXlRppg/8tBTKYhAsrbLePAiEA+h7OLUf3dXxBuypQsYkdkqigNrxnIMfyqBY0aTOviIQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":434362},"main":"./lib/server.js","type":"module","engines":{"node":"^22.19.0 || >=24.0.0"},"exports":{".":"./lib/server.js","./package.json":"./package.json"},"gitHead":"6fd7797d42759cb29e06ffc8784f20bd617df02a","scripts":{"test":"node --test test/unit/*.test.mjs","check":"npm test && npm run test:e2e","start":"node bin/browser-use-mcp.mjs","doctor":"node bin/browser-use-mcp.mjs doctor","test:e2e":"node test/e2e/stdio.mjs && node test/e2e/http.mjs && node test/e2e/attach.mjs && node test/e2e/intent.mjs && node test/e2e/protocol.mjs","release:pack":"node bin/check-package.mjs","release:check":"node bin/check-release.mjs","install-engine":"node bin/browser-use-mcp.mjs install","prepublishOnly":"npm run release:check","test:e2e:attach":"node test/e2e/attach.mjs","test:e2e:intent":"node test/e2e/intent.mjs","test:e2e:protocol":"node test/e2e/protocol.mjs"},"_npmUser":{"name":"ricardochen1996","email":"chenweitech@qq.com"},"repository":{"url":"git+https://github.com/ricardochen1996/browser-use-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"An MCP server that gives any agent a browser it can see and click: the page is read as an indexed action space, and every step is one guarded operation on an observed target.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/browser-use-mcp_0.1.0_1793107005070_0.9807123913497466","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ricardochen1996/browser-use-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","browser","browser-use","browser-automation","cdp","jev","agent"],"license":"MIT","_id":"@ricardochen1996/browser-use-mcp@0.1.1","maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"homepage":"https://github.com/ricardochen1996/browser-use-mcp#readme","bugs":{"url":"https://github.com/ricardochen1996/browser-use-mcp/issues"},"bin":{"browser-use-mcp":"bin/browser-use-mcp.mjs"},"dist":{"shasum":"6241ba23671ab43539cba886e3d4e032ae2c936d","tarball":"https://registry.npmjs.org/@ricardochen1996/browser-use-mcp/-/browser-use-mcp-0.1.1.tgz","fileCount":28,"integrity":"sha512-HHZyylWd1AfBQeBhva7UNEc6kuB+ZqnFe3epOgd5ZcWxBbAqdgf8qD8C1bbsNIafdfI1QZ+Zbr9H1SWRgl/vVg==","signatures":[{"sig":"MEYCIQCA4UV4WrI/DgQieCnoZykQGnxkAb96kbA/5dcxo/c0ogIhAMaWRm05eWw3gbiDRgemiMz+ongbrYl6GfkFiKHljPm3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDJfn9OWMfKt6JkHiUlcMQXpIsq5m0AXkzLWSXm9nBztQIgU0TH2xK+eYVBCAHqYWB1bAIMunWxpZHYikPUBPWOHBg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ricardochen1996%2fbrowser-use-mcp@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":436236},"main":"./lib/server.js","type":"module","engines":{"node":"^22.19.0 || >=24.0.0"},"exports":{".":"./lib/server.js","./package.json":"./package.json"},"gitHead":"780ff040b0429f3d39d379d69310c81182ef4110","scripts":{"test":"node --test test/unit/*.test.mjs","check":"npm test && npm run test:e2e","start":"node bin/browser-use-mcp.mjs","doctor":"node bin/browser-use-mcp.mjs doctor","test:e2e":"node test/e2e/stdio.mjs && node test/e2e/http.mjs && node test/e2e/attach.mjs && node test/e2e/intent.mjs && node test/e2e/protocol.mjs","release:pack":"node bin/check-package.mjs","release:check":"node bin/check-release.mjs","install-engine":"node bin/browser-use-mcp.mjs install","prepublishOnly":"npm run release:check","test:e2e:attach":"node test/e2e/attach.mjs","test:e2e:intent":"node test/e2e/intent.mjs","test:e2e:protocol":"node test/e2e/protocol.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"35e32ff9-ed1d-481b-b611-9dd633443cae"}},"repository":{"url":"git+https://github.com/ricardochen1996/browser-use-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"An MCP server that gives any agent a browser it can see and click: the page is read as an indexed action space, and every step is one guarded operation on an observed target.","directories":{},"_nodeVersion":"24.22.1","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/browser-use-mcp_0.1.1_1793111463140_0.6688458829324407","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ricardochen1996/browser-use-mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","browser","browser-use","browser-automation","cdp","jev","agent"],"license":"MIT","_id":"@ricardochen1996/browser-use-mcp@0.1.2","maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"homepage":"https://github.com/ricardochen1996/browser-use-mcp#readme","bugs":{"url":"https://github.com/ricardochen1996/browser-use-mcp/issues"},"bin":{"browser-use-mcp":"bin/browser-use-mcp.mjs"},"dist":{"shasum":"70f5a3e46524d8f0d26e378eb5aecb793c90813c","tarball":"https://registry.npmjs.org/@ricardochen1996/browser-use-mcp/-/browser-use-mcp-0.1.2.tgz","fileCount":28,"integrity":"sha512-NJurhTG8goFw5y6hiaOarHZutG55TmcB9Qmd7rMAUjI+1nAnWUoHnH7ruCtpmGMdKTKrmHO/PpYCcv/vs7zd4Q==","signatures":[{"sig":"MEUCIDdihhBkPgd7X8BpEoRbWdNs/xP9Fa8O/t3A6DBtzcSFAiEA5NmwFIW2900y2lKp0RfNR/VWFqK8YT7PPZ5Som9P+XI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC/y7s4VHH+j97UVl49RsltaE1l0YHvZ3qNDf6gFvICJwIgKG7Ql2UDxUgJdl/N8sQPHMIs77NLTZ9z9cdhV6Y3e+Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ricardochen1996%2fbrowser-use-mcp@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":440932},"main":"./lib/server.js","type":"module","engines":{"node":"^22.19.0 || >=24.0.0"},"exports":{".":"./lib/server.js","./package.json":"./package.json"},"gitHead":"5f139a53d544e13ea040db3ecb7760911029b88e","scripts":{"test":"node --test test/unit/*.test.mjs","check":"npm test && npm run test:e2e","start":"node bin/browser-use-mcp.mjs","doctor":"node bin/browser-use-mcp.mjs doctor","test:e2e":"node test/e2e/stdio.mjs && node test/e2e/http.mjs && node test/e2e/attach.mjs && node test/e2e/intent.mjs && node test/e2e/protocol.mjs","release:pack":"node bin/check-package.mjs","release:check":"node bin/check-release.mjs","install-engine":"node bin/browser-use-mcp.mjs install","prepublishOnly":"npm run release:check","test:e2e:attach":"node test/e2e/attach.mjs","test:e2e:intent":"node test/e2e/intent.mjs","test:e2e:protocol":"node test/e2e/protocol.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"35e32ff9-ed1d-481b-b611-9dd633443cae"}},"repository":{"url":"git+https://github.com/ricardochen1996/browser-use-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"An MCP server that gives any agent a browser it can see and click: the page is read as an indexed action space, and every step is one guarded operation on an observed target.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/browser-use-mcp_0.1.2_1793153070670_0.418578670668068","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@ricardochen1996/browser-use-mcp","version":"0.1.3","keywords":["mcp","model-context-protocol","browser","browser-use","browser-automation","cdp","jev","agent"],"license":"MIT","_id":"@ricardochen1996/browser-use-mcp@0.1.3","maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"homepage":"https://github.com/ricardochen1996/browser-use-mcp#readme","bugs":{"url":"https://github.com/ricardochen1996/browser-use-mcp/issues"},"bin":{"browser-use-mcp":"bin/browser-use-mcp.mjs"},"dist":{"shasum":"7ca0a815f4b4a57218825b41e1321dcb1d930a74","tarball":"https://registry.npmjs.org/@ricardochen1996/browser-use-mcp/-/browser-use-mcp-0.1.3.tgz","fileCount":31,"integrity":"sha512-WwatTZeJo0FdbR//Ya2Y6nG+sRdvEnaxB/w8ycwD1W6GIDTe+kLn80kX7JIggGxQmTKzX5SHs2RccViv31rSFw==","signatures":[{"sig":"MEUCIQClS+a4TwtGFdI5YpX/rzJ1ehNkJNQ0ZJMID0H1Wn1RJQIgWRPg4OHebVzxa9d12JkOBFEX8PyZ3zSzcmldUayVA08=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIH2bQTWaSyTirVBE9G/xvxzbqYu3IBIRNEcNHvzWk53uAiEArWScjwnKYVA1HAsLv5L74zTjVkla4MaYukBiNxQN0bM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ricardochen1996%2fbrowser-use-mcp@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":474961},"main":"./lib/server.js","type":"module","engines":{"node":"^22.19.0 || >=24.0.0"},"exports":{".":"./lib/server.js","./package.json":"./package.json"},"gitHead":"d24129da27ab351f2d625319083f673720565f79","scripts":{"test":"node --test test/unit/*.test.mjs","check":"npm test && npm run test:e2e","start":"node bin/browser-use-mcp.mjs","doctor":"node bin/browser-use-mcp.mjs doctor","test:e2e":"node test/e2e/stdio.mjs && node test/e2e/http.mjs && node test/e2e/attach.mjs && node test/e2e/daemon-isolation.mjs && node test/e2e/intent.mjs && node test/e2e/protocol.mjs","release:pack":"node bin/check-package.mjs","release:check":"node bin/check-release.mjs","install-engine":"node bin/browser-use-mcp.mjs install","prepublishOnly":"npm run release:check","test:e2e:attach":"node test/e2e/attach.mjs","test:e2e:intent":"node test/e2e/intent.mjs","test:e2e:protocol":"node test/e2e/protocol.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"35e32ff9-ed1d-481b-b611-9dd633443cae"}},"repository":{"url":"git+https://github.com/ricardochen1996/browser-use-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"An MCP server that gives any agent a browser it can see and click: the page is read as an indexed action space, and every step is one guarded operation on an observed target.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/browser-use-mcp_0.1.3_1793163431358_0.23368330745704546","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@ricardochen1996/browser-use-mcp","version":"0.1.4","keywords":["mcp","model-context-protocol","browser","browser-use","browser-automation","cdp","jev","agent"],"license":"MIT","_id":"@ricardochen1996/browser-use-mcp@0.1.4","maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"homepage":"https://github.com/ricardochen1996/browser-use-mcp#readme","bugs":{"url":"https://github.com/ricardochen1996/browser-use-mcp/issues"},"bin":{"browser-use-mcp":"bin/browser-use-mcp.mjs"},"dist":{"shasum":"dbd4d267017632b01b9608eff1e98edc6f9066d1","tarball":"https://registry.npmjs.org/@ricardochen1996/browser-use-mcp/-/browser-use-mcp-0.1.4.tgz","fileCount":31,"integrity":"sha512-Hn7U90nRe11vvog/JCaKqmSathfvMPbfGQZrk+4vuqL8DETI3UqvJXQCE4HjQRvyZboN22mMuz0/jdWfNdG3gw==","signatures":[{"sig":"MEUCIQDVctHl6FaMAi2mcdsBawTe4How0SYv6rpudgSFjZHzawIgNGeGNcmQzuoxkcWdTlp3i/KDZpGBg+9FFQjDic2nCjw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDinhrc/xGopqatx7CW7MaJVsGiM8S5AtbS46yt4qoYBAIgF7dwKsxUI8BHyiJ/CSa0iyHEf2Oy0PmzQg2Fo43vYI8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ricardochen1996%2fbrowser-use-mcp@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":499522},"main":"./lib/server.js","type":"module","engines":{"node":"^22.19.0 || >=24.0.0"},"exports":{".":"./lib/server.js","./package.json":"./package.json"},"gitHead":"21fb180381f645128498d05c3a4965e9c989ff98","scripts":{"test":"node --test test/unit/*.test.mjs","check":"npm test && npm run test:e2e","start":"node bin/browser-use-mcp.mjs","doctor":"node bin/browser-use-mcp.mjs doctor","test:e2e":"node test/e2e/stdio.mjs && node test/e2e/http.mjs && node test/e2e/attach.mjs && node test/e2e/daemon-isolation.mjs && node test/e2e/intent.mjs && node test/e2e/protocol.mjs","release:pack":"node bin/check-package.mjs","release:check":"node bin/check-release.mjs","install-engine":"node bin/browser-use-mcp.mjs install","prepublishOnly":"npm run release:check","test:e2e:local":"bash scripts/e2e-local.sh","test:e2e:attach":"node test/e2e/attach.mjs","test:e2e:intent":"node test/e2e/intent.mjs","test:e2e:protocol":"node test/e2e/protocol.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"35e32ff9-ed1d-481b-b611-9dd633443cae"}},"repository":{"url":"git+https://github.com/ricardochen1996/browser-use-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"An MCP server that gives any agent a browser it can see and click: the page is read as an indexed action space, and every step is one guarded operation on an observed target.","directories":{},"_nodeVersion":"24.22.1","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/browser-use-mcp_0.1.4_1793262636313_0.8578335601633567","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"_id":"@ricardochen1996/browser-use-mcp@0.1.5","bin":{"browser-use-mcp":"bin/browser-use-mcp.mjs"},"bugs":{"url":"https://github.com/ricardochen1996/browser-use-mcp/issues"},"dist":{"shasum":"f17155c2ca2a3cf4eb58b0ce3ae5ec5ec1aa1d77","tarball":"https://registry.npmjs.org/@ricardochen1996/browser-use-mcp/-/browser-use-mcp-0.1.5.tgz","fileCount":33,"integrity":"sha512-6cheWqEzeRROMmnsN/cUZTv6YL1XWc212VMJMSTBCyPJHK+pc5fNd0l/IoOpY2XgfLlCHeLpyVuJBxXKAbcg0w==","signatures":[{"sig":"MEUCIHzPRxEfAn/bp9x14knJeyg820GdFDf7Q7c+75+ViLLzAiEAkKP2tiaFizGkQ8hF2kcWZ0ihWT+vVCJKp2sR2WTJbCc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDDsHLRF1sncKuGn7Pc+MS6GKfGiu689/v+CaOXr6ZuzwIgNZEl4giF3RtNGZgROEWcOYsLDF+Vf6SDOFl6BckMniw="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ricardochen1996%2fbrowser-use-mcp@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":512069},"main":"./lib/server.js","name":"@ricardochen1996/browser-use-mcp","type":"module","engines":{"node":"^22.19.0 || >=24.0.0"},"exports":{".":"./lib/server.js","./package.json":"./package.json"},"gitHead":"ae0f9c8522ea7185c6d12fc47089287034e7a17b","license":"MIT","scripts":{"test":"node --test test/unit/*.test.mjs","check":"npm test && npm run test:e2e","start":"node bin/browser-use-mcp.mjs","doctor":"node bin/browser-use-mcp.mjs doctor","test:e2e":"node test/e2e/stdio.mjs && node test/e2e/http.mjs && node test/e2e/attach.mjs && node test/e2e/daemon-isolation.mjs && node test/e2e/intent.mjs && node test/e2e/protocol.mjs","release:pack":"node bin/check-package.mjs","release:check":"node bin/check-release.mjs","install-engine":"node bin/browser-use-mcp.mjs install","prepublishOnly":"npm run release:check","test:e2e:local":"bash scripts/e2e-local.sh","test:e2e:attach":"node test/e2e/attach.mjs","test:e2e:intent":"node test/e2e/intent.mjs","test:e2e:protocol":"node test/e2e/protocol.mjs"},"version":"0.1.5","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"35e32ff9-ed1d-481b-b611-9dd633443cae"}},"homepage":"https://github.com/ricardochen1996/browser-use-mcp#readme","keywords":["mcp","model-context-protocol","browser","browser-use","browser-automation","cdp","jev","agent"],"repository":{"url":"git+https://github.com/ricardochen1996/browser-use-mcp.git","type":"git"},"_npmVersion":"11.21.2","description":"An MCP server that gives any agent a browser it can see and click: the page is read as an indexed action space, and every step is one guarded operation on an observed target.","directories":{},"maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/browser-use-mcp_0.1.5_1794554296793_0.08011821575635036"}}},"time":{"created":"2026-10-27T13:15:23.024Z","modified":"2026-11-13T07:18:17.247Z","0.0.0-stage":"2026-10-27T13:15:23.024Z","0.1.0":"2026-10-27T13:16:45.176Z","0.1.1":"2026-10-27T14:31:03.248Z","0.1.2":"2026-10-28T02:04:30.777Z","0.1.3":"2026-10-28T04:57:11.541Z","0.1.4":"2026-10-29T08:30:36.445Z","0.1.5":"2026-11-13T07:18:16.907Z"},"bugs":{"url":"https://github.com/ricardochen1996/browser-use-mcp/issues"},"license":"MIT","homepage":"https://github.com/ricardochen1996/browser-use-mcp#readme","keywords":["mcp","model-context-protocol","browser","browser-use","browser-automation","cdp","jev","agent"],"repository":{"url":"git+https://github.com/ricardochen1996/browser-use-mcp.git","type":"git"},"description":"An MCP server that gives any agent a browser it can see and click: the page is read as an indexed action space, and every step is one guarded operation on an observed target.","maintainers":[{"name":"ricardochen1996","email":"chenweitech@qq.com"}],"readme":"# @ricardochen1996/browser-use-mcp\n\n[![CI](https://github.com/ricardochen1996/browser-use-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/ricardochen1996/browser-use-mcp/actions/workflows/ci.yml)\n\n[English](README.md) · **中文**\n\n> 一个 MCP 服务器，给**任何 agent** 一双能看、能点的浏览器：页面被读成一张**带索引的动作空间表**，模型每步只做一个操作、只对一个来自那张表的目标。\n\n`browser-use-mcp` 是一个 [Model Context Protocol](https://modelcontextprotocol.io) 服务器。Claude Code、Claude Desktop、Cursor、Codex、DeepSeek Harness 会话，或者任何其他 MCP 客户端连上它，它的 agent 就得到一个浏览器：打开页面，把页面读成一张带编号目标的表，然后指明一个操作和一个目标。模型永远不用写选择器、坐标或脚本，服务器也永远不会自己重试一次改动。\n\n它建立在 [`dsh-browser-use`](https://github.com/ricardochen1996/dsh-browser-use) 之上：同一个 Python 引擎、同一套 sidecar 协议、同一个“页面即带索引动作空间”的想法——只是把 DeepSeek Harness 插件宿主换成了 MCP 宿主。所以它本身不含浏览器逻辑：这个包是适配层，让任何 MCP 客户端都能驱动 [Jev Ultrafast](https://github.com/ricardochen1996/jev-ultrafast) 引擎。引擎以固定版本的 wheel 随包发布，sidecar 的依赖按版本和每个产物的哈希锁定；首次使用时它们被装进一个由本服务器管理的 Python 环境。不用克隆引擎，不手动配 Python。\n\n---\n\n## 这是什么\n\n浏览器工具只暴露一条循环：\n\n1. **读。** `browser_open` 打开页面，把它的**动作空间**作为文本返回：每个可达元素一行，写明该元素支持哪些操作，以及这些操作接受的确切目标索引。结果里带一个**观测号**。\n2. **选。** agent 从**那个观测**里挑一个操作和一个目标：`browser_act({ observation, operation, target })`。\n3. **守。** 服务器把操作连同那个观测的指纹一起发给引擎。引擎先重读页面。页面变了就**什么都不执行**，结果以 `Nothing was executed:` 开头，并附上新的表。这是一次拒绝，不是错误：agent 从一件仍然为真的事上重新选。\n4. **验。** 页面没变，那一个操作才执行，服务器返回新的观测号。下一步引用新的编号。工具结果本身从来不是结果的证明；下一次观测才是。\n\n下面是一张真实的表，由随包的测试页面产生（可见文本那一行做了截断）：\n\n```text\nPage file:///…/test/fixtures/fixture.html — 🐴 Forma · Find a place to slow down\nObservation 1. Targets below are valid only for this observation.\nVisible text: forma. Find a stay Reading room PLACES WITH CHARACTER THE SLOWER WAY TO STAY …\n[1] link forma. — CLICK\n[2] link Find a stay — CLICK\n[3] link Reading room — CLICK\n[4] searchbox Destination — TYPE_TEXT, CLICK\n[5] button Find stays — CLICK\n[6] combobox Stay category · \"All stays\" — SELECT\n      6:1 → Stay category → Design\n      6:2 → Stay category → Nature\n      6:3 → Stay category → Coastal\n[7] checkbox Free cancellation · \"on\" (not checked) — CLICK\n[8] button View Casa Flora — CLICK\n[9] button View The Glasshouse — CLICK\n[10] button View Serra Lodge — CLICK\nWithout a target: SCROLL_DOWN, WAIT\n```\n\n对这张表的一步是一个对象，不是代码：\n\n```jsonc\n{ \"observation\": 1, \"operation\": \"CLICK\", \"target\": \"5\" }             // button Find stays\n{ \"observation\": 1, \"operation\": \"TYPE_TEXT\", \"target\": \"4\", \"text\": \"Lisbon\" }\n{ \"observation\": 1, \"operation\": \"SELECT\", \"target\": \"6:1\" }          // Stay category → Design\n```\n\n如果页面在读和点之间变了，回答是一次拒绝，并直接把当前观测交回来：\n\n```text\nNothing was executed: The page changed since that observation. Choose from the new one.\n\nPage … — …\nObservation 3. Targets below are valid only for this observation.\n```\n\n引擎通过本服务器会话持有的一条 CDP 连接读页面。每个工具——包括 `browser_eval`——都用这一条连接。自己再起第二个客户端（裸 websocket、puppeteer/playwright 脚本、另一个 `browser-harness` daemon）时，Chrome 144+ 的 “Allow remote debugging?” 提示（每个连接都要点一次）就会变成一堆弹窗，页面也会被两套循环同时驱动。\n\n## 与基于选择器的浏览器 MCP 有什么不同\n\n| | 基于选择器的浏览器 MCP | `browser-use-mcp` |\n| --- | --- | --- |\n| 模型发送什么 | 选择器、坐标或代码 | 对刚读到的那张表里的一个索引做一个操作 |\n| 页面变了会怎样 | 选择器可能点空，或点到错的元素 | 操作被**拒绝**，并返回最新的表 |\n| 重试 | 由客户端或模型决定 | **从不**——拒绝就是重新选择的起点，不是自动重放 |\n| 模型怎么知道能做什么 | 得猜 | 每一行写明该元素的目标与操作，下拉选项也在内 |\n| CDP 连接 | 取决于实现 | 每个浏览器会话恰好一条，所有工具共用 |\n| 每步 token 成本 | 常常是一张截图或整棵 DOM | 结构化文本：可见文本加元素表 |\n\n`browser_eval` 是唯一一处有意的例外：它在同一条连接上求值一个 JavaScript 表达式，把结果当数据返回，并且**不产生观测**——所以下一次受保护的操作仍然指向上一张表。它存在的原因，是需要程序化读取的模型不必再起第二个 CDP 客户端。`--no-eval` 可以把它收回。\n\n---\n\n## 快速开始\n\n**需要** Node.js `^22.19.0 || >=24.0.0`、Chrome 或 Chromium，以及一个能拿到 Python 3.12+ 的途径：`PATH` 上的 `python3.12`–`python3.14`、`python3`（3.12 或更新），或者 [uv](https://docs.astral.sh/uv/)（它能自己下载 Python）。可执行文件会检查自己所在的运行时：如果客户端用旧版 Node 启动它，它会在 `PATH` 以及常见的 nvm/fnm/mise/asdf 目录里找一个受支持的 Node 并用它重新启动；一个都找不到时，它会直接报出所需的版本范围，而不是让依赖里的语法错误炸掉进程。\n\n**驱动哪个浏览器。** 默认是 **attach** 模式：服务器直接驱动你日常用的 Chrome，agent 看到的登录态和标签页就是你自己的。先在那个 Chrome 里打开一次远程调试（`chrome://inspect/#remote-debugging` → 允许）；macOS 上还需要给运行服务器的应用**完全磁盘访问权限**（系统设置 → 隐私与安全性 → 完全磁盘访问权限）。想要一个隔离的浏览器，就加 `--mode launch`，服务器会在状态根下用自己的 profile 启动一个专属 Chrome。\n\n**安装。** 这个包已发布到 npm：\n[`@ricardochen1996/browser-use-mcp`](https://www.npmjs.com/package/@ricardochen1996/browser-use-mcp)，\n不装任何东西也可以直接跑最新版：\n\n```bash\nnpx -y @ricardochen1996/browser-use-mcp@latest --version\n```\n\n或者安装 `browser-use-mcp` 命令，下面终端里的命令都按这个写法：\n\n```bash\nnpm install -g @ricardochen1996/browser-use-mcp@latest\nbrowser-use-mcp --version\n```\n\n两种方式跑的是同一个服务器：下文任意命令里的 `browser-use-mcp` 都可以换成\n`npx -y @ricardochen1996/browser-use-mcp@latest`。客户端配置用 `npx` 或已安装的命令都可以；\nGUI 客户端的 `PATH` 比较短、找不到它们时，把 `command -v browser-use-mcp` 给出的绝对路径填进去\n（用 `npx` 形式则取 `command -v npx`）；每个客户端的片段见 [docs/clients.md](docs/clients.md)。\n\n然后检查这台机器（新机器上首次浏览器调用会构建环境；`install` 可以提前做）。下面的例子用\n`--mode launch` 看专属浏览器；默认 attach 模式下 `Connection:` 行会写成你所连的 Chrome，且\n`Status: ready` 要求那个浏览器能应答调试端点。输出大致如下，与机器相关的路径做了省略：\n\n```bash\nbrowser-use-mcp doctor --mode launch\n```\n\n```text\nbrowser-use-mcp v0.1.4 — self-check (Node v22.23.2, darwin-arm64)\n\nTransport: stdio (MCP over stdin/stdout)\nConnection: launch Chrome/Chromium, profile \"default\" at /Users/you/.browser-use-mcp/profiles/default\nState   : /Users/you/.browser-use-mcp (managed Python environment)\nTimeouts: 180s per browser request\nLogging : info (stderr)\nJev     : on, typesafe decider: default endpoint (model default), key unset; …\nTools   : browser_open, browser_page, browser_act, browser_eval, browser_screenshot, browser_console, browser_goal, browser_close, browser_doctor\nSession : idle (this transport has no browser session yet)\n\nEngine   : /Users/you/.browser-use-mcp/env/bin/python (Python 3.12.14, chosen by managed environment)\n           jev_ultrafast 0.1.2 at …/env/lib/python3.12/site-packages/jev_ultrafast\n           browser-harness 0.1.13\nInstall  : none in this process; the engine is already importable\nSidecar  : /…/node_modules/@ricardochen1996/browser-use-mcp/sidecar/bridge.py\nBrowser  : /Applications/Google Chrome.app/Contents/MacOS/Google Chrome\nGoal mode: enabled: browser_goal and browser_act intents spend model quota; …\nStatus   : ready\n```\n\n`Status: ready` 表示浏览器工具可用。`Jev … NOT READY` 在没配策略密钥时是正常的：只有 `browser_goal` 和 `browser_act` 的 `intent` 需要它，其余功能照常。\n\n想提前构建环境、而不是等第一次浏览器调用时再装：\n\n```bash\nbrowser-use-mcp install\n# 或者不装全局命令：\nnpx -y @ricardochen1996/browser-use-mcp@latest install\n```\n\n它会在 `<state root>/env`（默认 `~/.browser-use-mcp/env`）里建好环境，装上随包的引擎 wheel 与 `browser-harness`，并把构建记录写进 `<state root>/install.json`。可以放心重跑。安装在后台进行时，先到的浏览器调用会等它，而不是直接失败。\n\n### 接到你的 agent 上\n\n下面的片段用 `npx` 启动已发布的包，不需要全局安装。如果你装了 `browser-use-mcp` 命令，把\n`npx -y @ricardochen1996/browser-use-mcp@latest` 换成 `browser-use-mcp`（或它的绝对路径）即可。\n每个客户端（包括 launch 模式的变体）的完整配置在 **[docs/clients.md](docs/clients.md)**。\n\nClaude Code：\n\n```bash\n# 使用你日常的 Chrome（默认 attach 模式）：\nclaude mcp add --scope user browser-use \\\n  -- npx -y @ricardochen1996/browser-use-mcp@latest\n\n# 或者给 agent 一个专属的、看不到你日常会话的浏览器：\nclaude mcp add --scope user browser-use \\\n  --env BROWSER_USE_MCP_MODE=launch --env BROWSER_USE_MCP_HEADLESS=1 \\\n  -- npx -y @ricardochen1996/browser-use-mcp@latest\n```\n\n通用的 `mcpServers` JSON（Claude Desktop、Cursor 以及多数宿主都认这个形状）：\n\n```json\n{\n  \"mcpServers\": {\n    \"browser-use\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ricardochen1996/browser-use-mcp@latest\"],\n      \"env\": { \"BROWSER_USE_MCP_MODE\": \"launch\", \"BROWSER_USE_MCP_HEADLESS\": \"1\" }\n    }\n  }\n}\n```\n\n`env` 里用 launch 模式是为了让这个例子自成一体；想驱动你日常的 Chrome 就把这段 `env` 去掉。\n客户端也可以直接运行装好的命令（`\"command\": \"browser-use-mcp\"`）；如果希望整个团队跑同一个\n版本，就把 `@latest` 换成具体的版本号。GUI 客户端的 `PATH` 比较短时，用命令的绝对路径\n（`command -v browser-use-mcp`；Homebrew 装的 Node 通常是 `/opt/homebrew/bin/browser-use-mcp`）。\n如果客户端坚持用自己找到的旧版 Node 启动服务器，可执行文件会尝试在 `PATH` 和 nvm/fnm/mise/asdf\n的目录里换用受支持的 Node；`PATH` 被裁剪得只剩一个旧版本时，仍然要把 `command` 写成 Node 22+\n的绝对路径。\n\n然后让 agent 去 `browser_open` 一个 URL。新机器上的第一次调用可能要等一两分钟来装环境，之后的调用立即开始。\n\n### 从源码运行\n\n想跑一个还没发布的提交，或者参与开发：\n\n```bash\ngit clone https://github.com/ricardochen1996/browser-use-mcp.git\ncd browser-use-mcp\nnpm install\nnode bin/browser-use-mcp.mjs doctor --mode launch\n```\n\n在 checkout 里执行 `npm link` 会把一个 `browser-use-mcp` 命令放进 `PATH`，运行的就是这份\ncheckout。发布包和 checkout 的文件完全一致，区别只在于 `browser-use-mcp` 来自 npm 还是\n`node bin/browser-use-mcp.mjs`。\n\n---\n\n## 九个工具\n\n| 工具 | 参数 | 做什么 |\n| --- | --- | --- |\n| `browser_open` | `url`（必填） | 启动（或复用）本会话的浏览器，打开页面，返回第一张动作空间表和观测号。 |\n| `browser_page` | — | 重读当前页面，给出**新的**观测号。页面自己变了、或者操作被拒绝之后用它。 |\n| `browser_act` | `observation`（必填）、`operation`、`target`、`text`、`intent` | 在那个观测上对一个目标做一个操作：`CLICK`、`TYPE_TEXT`、`SELECT`、`SCROLL_UP`、`SCROLL_DOWN`、`WAIT`。页面已变时返回拒绝和最新的表。Jev 开启时，只给 `intent`（不给 operation）就把这一步的决策交给策略。 |\n| `browser_eval` | `expression`（必填）、`timeout_ms` | 在本会话的 CDP 连接上求值一个 JavaScript 表达式；把值当数据返回，不产生观测。`--no-eval` 时隐藏。 |\n| `browser_screenshot` | — | 把可见视口作为 MCP 图片（JPEG）返回；不画目标框。`--no-screenshots` 时隐藏。 |\n| `browser_console` | — | 上一次读取以来的 console 消息、未捕获异常、失败请求和 `4xx`/`5xx` 响应。每次读取都会清空缓冲。 |\n| `browser_goal` | `url`、`goal` | 把整个目标交给策略，在它自己的标签页里跑；策略自己选每一步的操作和目标。会消耗模型配额。`--no-jev` 时隐藏。 |\n| `browser_close` | — | 关闭本会话的标签页。launch 模式下浏览器留着给下一次 `browser_open`；attach 模式下绝不关闭你所连的浏览器。 |\n| `browser_doctor` | `install`（可选布尔值） | 自检：解释器、引擎、浏览器、attach 目标、配置、会话，每个问题都带修法。`install: true` 会先构建缺失的环境。 |\n\n缺策略密钥、目标不支持、`TYPE_TEXT` 没给文本、页面已变，这些都是**正常工具结果里的拒绝**。浏览器或环境坏了才是失败调用（`isError`）。agent 应该报告失败，而不是盲目重试。\n\n---\n\n## 传输与并发\n\n| 传输 | 一个 agent 得到什么 | 两个 agent 得到什么 |\n| --- | --- | --- |\n| **stdio**（默认） | 一个服务器进程、一个浏览器会话 | 两个进程：attach 模式下各开一个标签页驱动同一个浏览器，launch 模式下是两个浏览器 |\n| **Streamable HTTP** | 一个 MCP 会话、一个浏览器会话 | 一个常驻服务器：attach 模式共用正在运行的浏览器，launch 模式下每个会话在专属浏览器里各用一个标签页 |\n\n想多个 agent 共用一个装好的服务器时，起一个 HTTP 端点：\n\n```bash\nbrowser-use-mcp \\\n  --transport http --host 127.0.0.1 --port 7331 --path /mcp\n```\n\n端点默认是 `http://127.0.0.1:7331/mcp`。每个 MCP `initialize` 会话都有自己的浏览器会话；默认 attach 模式下它们都驱动你日常用的 Chrome（见下面的 `--attach-sharing`），`--mode launch` 则让每个会话在专属浏览器里各用一个标签页。静默 15 分钟的会话会被关掉浏览器，并删除它的匿名 profile（`BROWSER_USE_MCP_HTTP_IDLE_MS` 可以改这个时限）。它没有认证：默认只绑回环地址，绑到非回环地址时启动日志会给出警告。确实要离开本机，就放在你自己控制的隧道或反向代理后面。\n\n**命名 profile（launch 模式）。** launch 模式下，匿名的 HTTP 会话拿到的是临时 profile，会话结束就删除。希望登录态跨重连保留的客户端，在 initialize 请求上给自己的 profile 起个名字：\n\n```text\nhttp://127.0.0.1:7331/mcp?profile=claude      （或请求头 X-Browser-Use-Profile: claude）\n```\n\n命名 profile 位于 `<状态根>/profiles/<服务器 profile>-<名字>`，会话结束后保留，同名的新会话会复用它。不同名字可以同时跑在各自 profile 上；两个同时存活的同名会话会被 profile 锁拒绝，而不是悄悄共用一个浏览器。名字是 1–32 个 `[A-Za-z0-9_-]` 字符。\n\n### 浏览器：attach（默认）还是 launch\n\n**`attach`（默认）**驱动你日常用的 Chrome：\n\n- 不带端点时，服务器通过 Chrome 写进 profile 的 `DevToolsActivePort` 找到它。先在那个 Chrome 里打开远程调试（`chrome://inspect/#remote-debugging`）。macOS 上这个文件受隐私保护，所以运行本服务器的应用需要**完全磁盘访问权限**（系统设置 → 隐私与安全性 → 完全磁盘访问权限），然后重启它。\n- **`--cdp-endpoint http://127.0.0.1:9333`**（或 `ws://…` 端点）驱动一个你指定、开着远程调试的浏览器。\n- `--attach-sharing shared`（默认）允许同时有多个 MCP 会话——甚至多个服务器进程——驱动同一个浏览器，各自一个标签页、各自一条 CDP 连接。Chrome 144+ 对每条连接都会问一次 “Allow remote debugging?”，所以两个 agent 至少会有两次弹窗；每个只批准一次，没被批准的弹窗不要重试。`--attach-sharing exclusive` 则拒绝第二个持有者，并给出修法——当两个 agent 绝不能碰同一个浏览器时，这是更安全的选择。\n- `browser_close` 只停本会话的标签页和 daemon，从不关闭所连的浏览器。\n\n**`--mode launch`** 会在状态根下用自己的 profile 启动一个专属 Chrome，日常浏览器和登录态不进入自动化。`browser_close` 把这个浏览器留给下一次 `browser_open`，连接结束时服务器关闭它。无头 CI 机器，或者不该看到你真实会话的 agent，适合用这个模式。\n\n---\n\n## 配置要点\n\n服务器设置都是一个 flag 配一个环境变量（策略用的是 `TYPESAFE_*`/`TEXT_MODEL_*`；少数几项只有环境变量）；两者同时出现时 flag 生效。完整的表格、解析规则、默认值和退出码在 **[docs/config.md](docs/config.md)**。\n\n| 设置 | Flag | 环境变量 | 默认值 |\n| --- | --- | --- | --- |\n| 传输 | `--transport`、`--host`、`--port`、`--path` | `BROWSER_USE_MCP_TRANSPORT`、`BROWSER_USE_MCP_HOST`、`BROWSER_USE_MCP_PORT`、`BROWSER_USE_MCP_PATH` | `stdio`、`127.0.0.1`、`7331`、`/mcp` |\n| 自己启动或接入 | `--mode`、`--cdp-endpoint` | `BROWSER_USE_MCP_MODE`、`BROWSER_USE_MCP_CDP_ENDPOINT` | `attach` |\n| attach 共享 | `--attach-sharing` | `BROWSER_USE_MCP_ATTACH_SHARING` | `shared`（仅 attach） |\n| 浏览器窗口 | `--headless` | `BROWSER_USE_MCP_HEADLESS` | 显示窗口 |\n| Profile | `--profile`、`--user-data-dir` | `BROWSER_USE_MCP_PROFILE`、`BROWSER_USE_MCP_USER_DATA_DIR` | 状态根下的 `default` |\n| 状态根 | `--home` | `BROWSER_USE_MCP_HOME` | `~/.browser-use-mcp` |\n| 解释器 | `--python` | `BROWSER_USE_MCP_PYTHON` | 托管环境 |\n| 工具面 | `--no-eval`、`--no-screenshots`、`--no-jev` | `BROWSER_USE_MCP_NO_EVAL`、`…_NO_SCREENSHOTS`、`…_NO_JEV` | 全部提供 |\n| 策略 | `--jev-decider` 及 `--typesafe-*` / `--text-model-*` | `JEV_DECIDER`、`TYPESAFE_*`、`TEXT_MODEL_*` | `typesafe` |\n| 请求时限 | `--request-timeout-ms` | `BROWSER_USE_MCP_REQUEST_TIMEOUT_MS` | `180000` ms |\n| 日志 | `--log-level` | `BROWSER_USE_MCP_LOG_LEVEL` | `info`，始终走 stderr |\n\n状态根目录结构：\n\n```text\n~/.browser-use-mcp/\n├── env/                        托管 Python 虚拟环境（引擎 + browser-harness）\n├── install.json                装了什么，用的哪种策略、哪个 Python\n├── profiles/<name>/            启动的 Chrome profile（登录态、标签页）；HTTP 命名 profile 也在这里\n└── attachments/<hash>.lock     attach 模式的 claim，每个 DevTools 端点一份\n```\n\n### Jev 策略\n\n`browser_goal` 在引擎里跑完整个决策循环；`browser_act` 只给 `intent`（不给 operation）时，把恰好一步决策交给同一个策略。两者都会消耗模型配额。由谁回答是配置决定的：\n\n- **`--jev-decider typesafe`**（默认）：TypeSafe 端点上的 Jev。需要 `TYPESAFE_API_KEY`；可选 `TYPESAFE_BASE_URL`、`TYPESAFE_MODEL`、`TYPESAFE_FALLBACK_URL`。\n- **`--jev-decider chat`**：引擎在回环地址上提供自己的 System One 协议，由一个聊天模型来回答。需要 `TEXT_MODEL_BASE_URL` 和 `TEXT_MODEL`（端点需要的话再加 `TEXT_MODEL_API_KEY`）。\n\n`TEXT_MODEL_*` 也负责在 agent 只给 intent、没给文本时写出 `TYPE_TEXT` 的值。两种都不配，其余工具面完全不变；策略工具会以一句话拒绝，并点名要设的变量。`--no-jev` 会彻底收回 `browser_goal` 和 `intent` 参数。\n\n把凭据放在客户端的 `env` 块（或 flag）里，不要放在 `args` 里：\n\n```json\n\"env\": {\n  \"TYPESAFE_API_KEY\": \"…\",\n  \"TEXT_MODEL_BASE_URL\": \"https://your-endpoint/v1\",\n  \"TEXT_MODEL\": \"your-model\",\n  \"TEXT_MODEL_API_KEY\": \"…\"\n}\n```\n\n服务器只在消耗配额的那一次请求里带上这些变量，不会把它们留在 sidecar 的环境里；doctor 只打印 `set`/`unset`，不打印值。\n\n---\n\n## 故障排查\n\n**先跑 `browser_doctor`。** 工具和 CLI 跑的是同一份自检；每条问题都带着修它的命令。\n\n```bash\nbrowser-use-mcp doctor\n```\n\n- **profile 已被占用。** 报错会点名 profile 和 `--profile`：停掉另一个服务器，或者给这个服务器一个自己的 `--profile <name>`。两个服务器驱动同一个浏览器 profile，是服务器会主动拒绝的唯一一种配置。\n- **attach 模式找不到浏览器。** 这是默认模式：在你日常的 Chrome 里打开 `chrome://inspect/#remote-debugging` 并允许远程调试，修正 `--cdp-endpoint`，或者用 `--mode launch` 让服务器起一个专属浏览器。doctor 会打印 `attach mode drives …` 和原因。macOS 上，给运行服务器的应用完全磁盘访问权限，它才能读到你的 Chrome profile。\n- **引擎还没装。** 首次使用会把它装进状态根；想提前装就运行 `browser-use-mcp install`（或 `npx -y @ricardochen1996/browser-use-mcp@latest install`），或者在 agent 里调 `browser_doctor` 并带上 `install: true`。走代理的话，给运行服务器的进程设 `HTTPS_PROXY`。\n- **`Jev … NOT READY`。** 设 `TYPESAFE_API_KEY`（或用 `--jev-decider chat` 配 `TEXT_MODEL_*`）。浏览器工具不需要它。\n- **客户端里看不到工具。** 客户端的 `env`/`args` 没送到服务器，或者改完没重启。在终端里跑同一条命令看 stderr；配置错误会以退出码 `2` 结束并点名出错的字段。\n- **Chrome 弹 “Allow remote debugging?”。** 有东西起了第二个 CDP 客户端。只批准那一个弹窗一次，绝不重试；程序化的工作改用 `browser_eval`。\n- **`browser_eval('document.body')` 返回 `{}`。** DOM 节点无法按值跨过 CDP 边界。改为返回可序列化的东西，比如 `document.body.innerText` 或 `JSON.stringify(document.body.getAttribute('class'))`。\n\n---\n\n## 安全说明\n\n- **页面内容是不可信数据。** 表里引用的文本是拿来读的，不是拿来执行的指令。服务器绝不会替 agent 执行页面返回的任何东西。\n- **`browser_eval` 按设计就是代码执行。** 它在页面里跑一个表达式，走本会话自己的连接，没有用户手势。想让模型输出永远不可能变成代码，就用 `--no-eval` 收回它；其余工具照常工作。\n- **HTTP 传输没有认证。** 把它绑在回环地址上（默认如此）。任何非回环绑定都会在日志里给出警告；只在可信网络或你自己控制的隧道后面暴露它。\n- **密钥不进日志、不进工具结果。** doctor 只打印 `set`/`unset`；凭据只交给消耗配额的那一次 sidecar 请求，不会被无关调用继承。\n- **默认模式驱动的是你自己的 Chrome**，包括登录态——attach 模式就是为了这个。当 agent 应该在隔离浏览器里工作、profile 只属于状态根时，用 `--mode launch`。\n- **一条连接，一个驱动。** 不要对同一个浏览器再起一个 CDP 客户端；Chrome 对每个连接单独授权，两个驱动会互相抢页面。\n\n---\n\n## 许可证与致谢\n\nMIT。见 [LICENSE](LICENSE) 和 [NOTICE](NOTICE)。\n\n本项目建立在 [`dsh-browser-use`](https://github.com/ricardochen1996/dsh-browser-use)（MIT）之上：`sidecar/bridge.py` 来自它，动作空间渲染、新鲜度规则、“一条连接”规则和 direct mode 的工具描述也都沿袭自它。浏览器引擎是 [`jev-ultrafast`](https://github.com/ricardochen1996/jev-ultrafast)（MIT），以固定版本的 wheel 随包发布；浏览器接入是 [`browser-harness`](https://github.com/browser-use/browser-harness)（MIT）。设计与取舍见 [docs/architecture.md](docs/architecture.md)。\n\n## 开发\n\n```bash\nnpm test            # 快速单元测试（node --test）\nnpm run test:e2e  # 真实 headless Chrome 跑真实 MCP 协议\n                  # （stdio、HTTP、attach 模式、用回环 stub 验证的 Jev intent、\n                  #  以及手写 JSON-RPC 客户端）\nnpm run test:e2e:local  # 在本机跑同一套 e2e：自动准备临时状态根和带 --no-sandbox 的 Chrome 包装\n                        # （沙箱里也能跑；`-- http attach` 可只跑指定 suite）\nnpm run release:check  # 校验版本、CHANGELOG 与真正会被打包的文件清单\nnpm run release:pack   # 构建 tarball、校验内容并把 integrity 记录到 dist/\nnpm run doctor      # CLI 自检\n```\n\n默认测试不花模型调用、不需要任何凭据；e2e 测试首次运行会把引擎装进一个测试用的状态根。`npm run test:e2e:local` 会自行设置 `BROWSER_USE_MCP_TEST_HOME`、`BH_RUNTIME_DIR` 和 `BROWSER_USE_MCP_TEST_CHROME`，不需要手动配置，也不会留下浏览器或 daemon。\n\nCI 在每次 push 和 PR 上跑 Node 22.19/24 的单元矩阵和 release gate；真浏览器 e2e 只在 `main` 和发版时跑。e2e suite 因时序失败会自动重试一次（失败先记 annotation），单元测试绝不重试：那属于缺陷而不是 flake。版本历史见 [CHANGELOG.md](CHANGELOG.md)。\n\n**发布**：在 `main` 上打标注 tag `vX.Y.Z`，[release 工作流](.github/workflows/release.yml) 会校验 tag 与 `package.json` 一致、重跑 CI（单元 + 真浏览器 e2e）、带 provenance 发布到 npm，并创建 GitHub Release，附上校验过的 tarball。凭据二选一：仓库 secret `NPM_TOKEN`（automation 或带 publish 权限的 granular token），或在 npm 上把本仓库与 `.github/workflows/release.yml` 配成 **Trusted Publisher**，工作流会用 OIDC 换取短期发布凭据。已发布的版本会被跳过，重跑只刷新 GitHub Release。\n\n---\n\n[![](https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white)](https://github.com/deepseek-ai/deepseek-harness)\n","readmeFilename":"README.zh-CN.md"}