{"_id":"@dacodedbeat/mcp-browser-buddy","_rev":"2-4b98816731a55089388f41ab09858102","name":"@dacodedbeat/mcp-browser-buddy","dist-tags":{"latest":"1.0.0"},"versions":{"0.0.1":{"name":"@dacodedbeat/mcp-browser-buddy","version":"0.0.1","keywords":["browser","chrome","mcp","tabs"],"author":{"name":"dacodedbeat"},"license":"MIT","_id":"@dacodedbeat/mcp-browser-buddy@0.0.1","maintainers":[{"name":"dacodedbeat","email":"dacodedbeat@gmail.com"}],"homepage":"https://github.com/dacodedbeat/mcp-browser-buddy#readme","bugs":{"url":"https://github.com/dacodedbeat/mcp-browser-buddy/issues"},"bin":{"mcp-browser-buddy":"dist/index.js"},"dist":{"shasum":"4ca68a778a4146af1668a5f150dc8bee610de1b4","tarball":"https://registry.npmjs.org/@dacodedbeat/mcp-browser-buddy/-/mcp-browser-buddy-0.0.1.tgz","fileCount":7,"integrity":"sha512-hRqW1UQcELzxoG0395U2TV/WqIsAMgcjkldLwW1qul9yit0nZyFPtdmpqfhppJBxiNOGeJDqg5AsUnjjtl4XZw==","signatures":[{"sig":"MEQCIGoc8aCk39Mols9T73zfdyUMBg6UGtngv5MFpBIPsMm+AiAwct89l6HtrndycLzUGTB99czLmTp10dzgAdtROCW+Mg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55898},"type":"module","engines":{"node":">=23.6.0"},"gitHead":"d35d9d1189251858ea49b556bd171676f40001cf","scripts":{"lint":"oxlint .","build":"tsc && chmod +x dist/index.js","start":"node --experimental-strip-types src/index.ts","format":"oxfmt .","prepack":"npm run typecheck && npm run lint && npm run format:check && npm run build","lint:fix":"oxlint --fix .","typecheck":"tsc --noEmit","format:check":"oxfmt --check ."},"_npmUser":{"name":"dacodedbeat","email":"dacodedbeat@gmail.com"},"repository":{"url":"git+https://github.com/dacodedbeat/mcp-browser-buddy.git","type":"git"},"_npmVersion":"11.11.0","description":"MCP server for browser control, tab management, and automation (currently Chrome-based)","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.13.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"oxfmt":"^0.54.0","oxlint":"^1.69.0","typescript":"^6.0.3","@types/node":"^25.9.3","semantic-release":"^25.0.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-browser-buddy_0.0.1_1781197299568_0.862212386560814","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@dacodedbeat/mcp-browser-buddy","version":"1.0.0","description":"MCP server for browser control, tab management, and automation (currently Chrome-based)","keywords":["browser","chrome","mcp","tabs"],"license":"MIT","author":{"name":"dacodedbeat"},"repository":{"type":"git","url":"git+https://github.com/DAcodedBEAT/mcp-browser-buddy.git"},"bin":{"mcp-browser-buddy":"dist/index.js"},"type":"module","publishConfig":{"access":"public"},"scripts":{"start":"node --experimental-strip-types src/index.ts","build":"tsc && chmod +x dist/index.js","typecheck":"tsc --noEmit","lint":"oxlint .","lint:fix":"oxlint --fix .","format":"oxfmt .","format:check":"oxfmt --check .","prepack":"npm run typecheck && npm run lint && npm run format:check && npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.13.2","zod":"^4.4.3"},"devDependencies":{"@types/node":"^25.9.3","oxfmt":"^0.54.0","oxlint":"^1.69.0","semantic-release":"^25.0.5","typescript":"^6.0.3"},"engines":{"node":">=23.6.0"},"gitHead":"4590d3459c0915981cf652f79da6da3ed3ecfa51","_id":"@dacodedbeat/mcp-browser-buddy@1.0.0","bugs":{"url":"https://github.com/DAcodedBEAT/mcp-browser-buddy/issues"},"homepage":"https://github.com/DAcodedBEAT/mcp-browser-buddy#readme","_nodeVersion":"24.16.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-oxAIMMClKbjTv5aaKV1KjEAcgyZalYaShdiHhka/39PnuwOzG3Pmfk5fZtwqDQYKM1xdab7G9bwdaZkTCCzOsw==","shasum":"8dfbd129805d1cdf913e070b3e99aa40c514dd68","tarball":"https://registry.npmjs.org/@dacodedbeat/mcp-browser-buddy/-/mcp-browser-buddy-1.0.0.tgz","fileCount":7,"unpackedSize":55894,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dacodedbeat%2fmcp-browser-buddy@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCPghKLAjFPyJqWnAAfBE4l8DqkgFxV+O9h79fxsNcnNQIhAKjD5XrcUvrd7sLUw/WVaRba+z9WjD6sIY+9+B6Fi+hP"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:facc0b8e-4d27-40d6-a9ed-e8a092b996db"}},"directories":{},"maintainers":[{"name":"dacodedbeat","email":"dacodedbeat@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-browser-buddy_1.0.0_1781202551258_0.33401834935852626"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-11T17:01:39.368Z","modified":"2026-06-11T18:29:11.631Z","0.0.1":"2026-06-11T17:01:39.707Z","1.0.0":"2026-06-11T18:29:11.400Z"},"bugs":{"url":"https://github.com/DAcodedBEAT/mcp-browser-buddy/issues"},"author":{"name":"dacodedbeat"},"license":"MIT","homepage":"https://github.com/DAcodedBEAT/mcp-browser-buddy#readme","keywords":["browser","chrome","mcp","tabs"],"repository":{"type":"git","url":"git+https://github.com/DAcodedBEAT/mcp-browser-buddy.git"},"description":"MCP server for browser control, tab management, and automation (currently Chrome-based)","maintainers":[{"name":"dacodedbeat","email":"dacodedbeat@gmail.com"}],"readme":"# MCP Browser Buddy\n\nModel Context Protocol server for retrieving and managing Chrome browser tabs information. This allows Claude Desktop (or any MCP client) to fetch information about and control currently open Chrome tabs.\n\n<a href=\"https://glama.ai/mcp/servers/wze1kc6emp\"><img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/wze1kc6emp/badge\" alt=\"Browser Tabs Server MCP server\" /></a>\n\n## Quick Start (For Users)\n\nTo use this tool with Claude Desktop, simply add the following to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"tools\": {\n    \"browser-buddy\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dacodedbeat/mcp-browser-buddy\"]\n    }\n  }\n}\n```\n\nThis will automatically download and run the latest version of the tool when needed.\n\n### Required Setup\n\n1. Enable Accessibility for Chrome:\n   - Open System Settings\n   - Go to Privacy & Security > Accessibility\n   - Click the \"+\" button\n   - Add Google Chrome from your Applications folder\n   - Turn ON the toggle for Chrome\n\nThis accessibility setting is required for AppleScript to interact with Chrome tabs.\n\n## For Developers\n\nThe following sections are for those who want to develop or modify the tool.\n\n### Prerequisites\n\n- Node.js 18+\n- macOS (for AppleScript operations)\n- Google Chrome\n- Claude Desktop (install from https://claude.ai/desktop)\n- tsx (install via `npm install -g tsx`)\n\n### Installation\n\n```bash\ngit clone https://github.com/dacodedbeat/mcp-browser-buddy.git\ncd mcp-browser-buddy\nnpm install\nnpm run build\n```\n\n## Security Considerations\n\n**This server provides powerful capabilities that give an LLM control over your web browser.**\n\nBy using this server, you are granting the connected LLM agent the ability to:\n\n- Read the content of all open browser tabs.\n- Navigate to arbitrary URLs.\n- Execute arbitrary JavaScript in the context of any page you have open.\n- Close tabs and windows.\n\nThese capabilities are necessary for the server's function but present security risks if connected to an untrusted or compromised LLM agent.\n\n**Recommendation:** Only use this server with trusted LLM clients and be aware of what pages you have open. Do not use this server in environments where sensitive, non-public data is frequently accessed in your browser tabs.\n\n## Available Tools\n\n- `get_tabs`: List every open tab across all windows.\n- `search_tabs`: Search for tabs by keyword in title or URL.\n- `get_active_tab`: Get details about the currently focused tab in the frontmost window.\n- `open_tabs`: Open one or more URLs in new tabs.\n- `close_tabs`: Permanently close one or more tabs by Tab ID.\n- `close_window`: Close an entire window and all its tabs.\n- `create_window`: Open a new browser window, optionally in incognito mode.\n- `activate_tab`: Bring a tab into focus.\n- `reload_tabs`: Reload one or more tabs by Tab ID.\n- `stop_tabs`: Stop loading one or more tabs by Tab ID.\n- `go_back`: Navigate back in the tab's history.\n- `go_forward`: Navigate forward in the tab's history.\n- `navigate_tab`: Change the URL of an existing tab.\n- `execute_script`: Run JavaScript in a tab's page context.\n\n## Schema Stability\n\nThis project adheres to strict schema evolution rules to ensure reliability for all connected MCP clients:\n\n1. **Breaking Changes**: Any change to tool definitions that breaks existing consumers (e.g., changing parameter names, removing parameters, changing types, or altering a tool's primary purpose) is treated as a major change.\n2. **Versioning**: We follow [Semantic Versioning (SemVer)](https://semver.org/):\n   - **MAJOR**: Breaking changes to the schema.\n   - **MINOR**: Adding new tools or extending parameters in a non-breaking way (e.g., adding an optional parameter).\n   - **PATCH**: Internal refactoring, performance improvements, or bug fixes that do not affect the tool schema.\n3. **Compatibility**: We prioritize maintaining backward compatibility. Changes to tool definitions are designed to ensure existing automation flows remain functional.\n\n## Notes\n\n- This tool is designed for **macOS only** due to its dependency on AppleScript.\n- Requires **Google Chrome** (or a compatible browser like Brave or Chromium) to be installed and running.\n- **Accessibility permissions** must be granted for the browser in System Settings for the tool to function.\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details\n","readmeFilename":"README.md"}