# https://github.com/Agent360dk/browser-mcp Project Manual
Generated on: 2026-05-22 17:31:43 UTC
## Table of Contents
- [Repository Overview](#overview)
- [Entrypoints and Runtime Surface](#entrypoints)
- [Architecture Evidence Map](#architecture)
- [Operations and Verification Boundaries](#operations)
## Repository Overview
### Related Pages
Related topics: [Entrypoints and Runtime Surface](#entrypoints), [Architecture Evidence Map](#architecture), [Operations and Verification Boundaries](#operations)
Relevant source files
The following source files were used to generate this page:
- [README.md](https://github.com/Agent360dk/browser-mcp/blob/main/README.md)
- [demo-video-src/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/package.json)
- [mcp-server/README.md](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/README.md)
- [mcp-server/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/package.json)
- [demo-video-src/src/Composition.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Composition.tsx)
- [demo-video-src/src/Demo.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Demo.tsx)
- [demo-video-src/src/Root.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Root.tsx)
- [demo-video-src/src/index.css](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.css)
- [demo-video-src/src/index.ts](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.ts)
- [demo-video-src/src/components/Browser.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Browser.tsx)
- [demo-video-src/src/components/Effects.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Effects.tsx)
- [demo-video-src/src/components/MorePages.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/MorePages.tsx)
# Repository Overview
This page is generated from repository evidence because the Human Wiki provider was unavailable. It intentionally limits itself to README and file-tree facts.
## README Evidence
# Browser MCP by Agent360
[](https://www.npmjs.com/package/@agent360/browser-mcp)
[](https://www.npmjs.com/package/@agent360/browser-mcp)
[](https://github.com/Agent360dk/browser-mcp)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl)
**Control your real Chrome from Claude Code — with your logins, cookies, and 2FA.**
The only browser MCP with **multi-session support** (10 concurrent AI sessions), **human-in-the-loop** (2FA, CAPTCHA, credentials), and **built-in provider integrations** (Stripe, HubSpot, Slack, and 6 more). 33 tools total.
## Install — 2 steps (~60 seconds)
### Step 1: Configure the MCP server
```bash
npx @agent360/browser-mcp install
```
This copies the Chrome extension files to `~/.browser-mcp/extension/` and adds the MCP server to your Claude Code config. **You'll see the path to the extension folder printed in the terminal — copy it.**
### Step 2: Load the extension in Chrome
> Chrome won't let extensions install themselves from npm — you have to load it manually one time. After that, it auto-updates whenever you re-run the install command.
1. **Open Chrome** and type `chrome://extensions` in the address bar
2. **Toggle "Developer mode"** ON (top right corner)
3. **Click "Load unpacked"** (top left, next to "Pack extension")
4. **Navigate to `~/.browser-mcp/extension/`** and click "Select"
- On Mac: Press `Cmd+Shift+G` in the file picker, paste `~/.browser-mcp/extension/`, press Enter
- On Windows: Paste `%USERPROFILE%\.browser-mcp\extension\` in the address bar
- On Linux: Type `~/.browser-mcp/extension/` in the path field
5. **Restart Claude Code** so it picks up the new MCP server
That's it. The Browser MCP icon will appear in your toolbar, and 33 browser tools are now available in Claude Code.
### Alternative: Manual zip download (no npm)
If you don't
[excerpt truncated]
## Selected Source Inventory
- `README.md`
- `demo-video-src/package.json`
- `mcp-server/README.md`
- `mcp-server/package.json`
- `demo-video-src/src/Composition.tsx`
- `demo-video-src/src/Demo.tsx`
- `demo-video-src/src/Root.tsx`
- `demo-video-src/src/index.css`
- `demo-video-src/src/index.ts`
- `demo-video-src/src/components/Browser.tsx`
- `demo-video-src/src/components/Effects.tsx`
- `demo-video-src/src/components/MorePages.tsx`
| File | Evidence role | Size |
|---|---|---|
| `README.md` | README/product and usage evidence | 10933 bytes |
| `demo-video-src/package.json` | package/runtime metadata | 747 bytes |
| `mcp-server/README.md` | documentation evidence | 8176 bytes |
| `mcp-server/package.json` | package/runtime metadata | 1367 bytes |
| `demo-video-src/src/Composition.tsx` | implementation surface | 55 bytes |
| `demo-video-src/src/Demo.tsx` | implementation surface | 27037 bytes |
| `demo-video-src/src/Root.tsx` | implementation surface | 408 bytes |
| `demo-video-src/src/index.css` | implementation surface | 59 bytes |
| `demo-video-src/src/index.ts` | implementation surface | 109 bytes |
| `demo-video-src/src/components/Browser.tsx` | implementation surface | 7468 bytes |
| `demo-video-src/src/components/Effects.tsx` | implementation surface | 6773 bytes |
| `demo-video-src/src/components/MorePages.tsx` | implementation surface | 7637 bytes |
Source: `[README.md:1-120]()`
---
## Entrypoints and Runtime Surface
### Related Pages
Related topics: [Repository Overview](#overview), [Architecture Evidence Map](#architecture), [Operations and Verification Boundaries](#operations)
Relevant source files
The following source files were used to generate this page:
- [README.md](https://github.com/Agent360dk/browser-mcp/blob/main/README.md)
- [demo-video-src/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/package.json)
- [mcp-server/README.md](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/README.md)
- [mcp-server/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/package.json)
- [demo-video-src/src/Composition.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Composition.tsx)
- [demo-video-src/src/Demo.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Demo.tsx)
- [demo-video-src/src/Root.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Root.tsx)
- [demo-video-src/src/index.css](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.css)
- [demo-video-src/src/index.ts](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.ts)
- [demo-video-src/src/components/Browser.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Browser.tsx)
- [demo-video-src/src/components/Effects.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Effects.tsx)
- [demo-video-src/src/components/MorePages.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/MorePages.tsx)
# Entrypoints and Runtime Surface
The files below are the highest-signal candidates for how the project is installed, started, configured, or embedded. Treat this as an evidence map, not an inferred API contract.
| File | Evidence role | Size |
|---|---|---|
| `README.md` | README/product and usage evidence | 10933 bytes |
| `demo-video-src/package.json` | package/runtime metadata | 747 bytes |
| `mcp-server/README.md` | documentation evidence | 8176 bytes |
| `mcp-server/package.json` | package/runtime metadata | 1367 bytes |
| `demo-video-src/src/Composition.tsx` | implementation surface | 55 bytes |
| `demo-video-src/src/Demo.tsx` | implementation surface | 27037 bytes |
| `demo-video-src/src/Root.tsx` | implementation surface | 408 bytes |
| `demo-video-src/src/index.css` | implementation surface | 59 bytes |
| `demo-video-src/src/index.ts` | implementation surface | 109 bytes |
| `demo-video-src/src/components/Browser.tsx` | implementation surface | 7468 bytes |
| `demo-video-src/src/components/Effects.tsx` | implementation surface | 6773 bytes |
| `demo-video-src/src/components/MorePages.tsx` | implementation surface | 7637 bytes |
Source: `[README.md:1-120](https://github.com/Agent360dk/browser-mcp/blob/main/README.md)`
---
## Architecture Evidence Map
### Related Pages
Related topics: [Repository Overview](#overview), [Entrypoints and Runtime Surface](#entrypoints), [Operations and Verification Boundaries](#operations)
Relevant source files
The following source files were used to generate this page:
- [README.md](https://github.com/Agent360dk/browser-mcp/blob/main/README.md)
- [demo-video-src/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/package.json)
- [mcp-server/README.md](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/README.md)
- [mcp-server/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/package.json)
- [demo-video-src/src/Composition.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Composition.tsx)
- [demo-video-src/src/Demo.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Demo.tsx)
- [demo-video-src/src/Root.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Root.tsx)
- [demo-video-src/src/index.css](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.css)
- [demo-video-src/src/index.ts](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.ts)
- [demo-video-src/src/components/Browser.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Browser.tsx)
- [demo-video-src/src/components/Effects.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Effects.tsx)
- [demo-video-src/src/components/MorePages.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/MorePages.tsx)
# Architecture Evidence Map
This section maps source paths into likely architectural areas based on repository layout only. Claims that require execution are intentionally not made here.
- `.`: `README.md`
- `demo-video-src`: `demo-video-src/package.json`, `demo-video-src/src/Composition.tsx`, `demo-video-src/src/Demo.tsx`, `demo-video-src/src/Root.tsx`, `demo-video-src/src/index.css`, `demo-video-src/src/index.ts`
- `mcp-server`: `mcp-server/README.md`, `mcp-server/package.json`
Source: `[demo-video-src/package.json:1-120](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/package.json)`
---
## Operations and Verification Boundaries
### Related Pages
Related topics: [Repository Overview](#overview), [Entrypoints and Runtime Surface](#entrypoints), [Architecture Evidence Map](#architecture)
Relevant source files
The following source files were used to generate this page:
- [README.md](https://github.com/Agent360dk/browser-mcp/blob/main/README.md)
- [demo-video-src/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/package.json)
- [mcp-server/README.md](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/README.md)
- [mcp-server/package.json](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/package.json)
- [demo-video-src/src/Composition.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Composition.tsx)
- [demo-video-src/src/Demo.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Demo.tsx)
- [demo-video-src/src/Root.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/Root.tsx)
- [demo-video-src/src/index.css](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.css)
- [demo-video-src/src/index.ts](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/index.ts)
- [demo-video-src/src/components/Browser.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Browser.tsx)
- [demo-video-src/src/components/Effects.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/Effects.tsx)
- [demo-video-src/src/components/MorePages.tsx](https://github.com/Agent360dk/browser-mcp/blob/main/demo-video-src/src/components/MorePages.tsx)
# Operations and Verification Boundaries
Operational guidance is limited to files that are present in the repository. Before using this project in an agent workflow, verify install, quickstart, and runtime behavior in a sandbox.
- Documentation signal: `README.md`
- Runtime/package signal: `demo-video-src/package.json`
- Documentation signal: `mcp-server/README.md`
- Runtime/package signal: `mcp-server/package.json`
- Source inspection signal: `demo-video-src/src/Composition.tsx`
- Source inspection signal: `demo-video-src/src/Demo.tsx`
- Source inspection signal: `demo-video-src/src/Root.tsx`
- Source inspection signal: `demo-video-src/src/index.css`
- Source inspection signal: `demo-video-src/src/index.ts`
- Source inspection signal: `demo-video-src/src/components/Browser.tsx`
Source: `[mcp-server/README.md:1-120](https://github.com/Agent360dk/browser-mcp/blob/main/mcp-server/README.md)`
---
---
## Doramagic Pitfall Log
Project: agent360dk/browser-mcp
Summary: Found 9 potential pitfall items; 1 are high/blocking. Highest priority: installation - 来源证据：Using browser-mcp remotely (linux + systemd solution).
## 1. installation · 来源证据：Using browser-mcp remotely (linux + systemd solution)
- Severity: high
- Evidence strength: source_linked
- Finding: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Using browser-mcp remotely (linux + systemd solution)
- User impact: 可能增加新用户试用和生产接入成本。
- Suggested check: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- Evidence: community_evidence:github | cevd_5c66b5c80c434888a9fd4ad95af8793f | https://github.com/Agent360dk/browser-mcp/issues/1 | 来源讨论提到 linux 相关条件，需在安装/试用前复核。
## 2. installation · 失败模式：installation: Using browser-mcp remotely (linux + systemd solution)
- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: Using browser-mcp remotely (linux + systemd solution)
- User impact: Developers may fail before the first successful local run: Using browser-mcp remotely (linux + systemd solution)
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: Using browser-mcp remotely (linux + systemd solution). Context: Observed when using linux
- Guardrail action: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_issue | fmev_9bfdeebbaac14508096abe351728049c | https://github.com/Agent360dk/browser-mcp/issues/1 | Using browser-mcp remotely (linux + systemd solution)
## 3. configuration · 可能修改宿主 AI 配置
- Severity: medium
- Evidence strength: source_linked
- Finding: 项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。
- User impact: 安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。
- Suggested check: 列出会写入的配置文件、目录和卸载/回滚步骤。
- Guardrail action: 涉及宿主配置目录时必须给回滚路径，不能只给安装命令。
- Evidence: capability.host_targets | mcp_registry:io.github.Agent360dk/browser-mcp:1.16.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Agent360dk%2Fbrowser-mcp/versions/1.16.1 | host_targets=mcp_host, claude, claude_code
## 4. capability · 能力判断依赖假设
- Severity: medium
- Evidence strength: source_linked
- Finding: README/documentation is current enough for a first validation pass.
- User impact: 假设不成立时，用户拿不到承诺的能力。
- Suggested check: 将假设转成下游验证清单。
- Guardrail action: 假设必须转成验证项；没有验证结果前不能写成事实。
- Evidence: capability.assumptions | mcp_registry:io.github.Agent360dk/browser-mcp:1.16.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Agent360dk%2Fbrowser-mcp/versions/1.16.1 | README/documentation is current enough for a first validation pass.
## 5. maintenance · 维护活跃度未知
- Severity: medium
- Evidence strength: source_linked
- Finding: 未记录 last_activity_observed。
- User impact: 新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
- Suggested check: 补 GitHub 最近 commit、release、issue/PR 响应信号。
- Guardrail action: 维护活跃度未知时，推荐强度不能标为高信任。
- Evidence: evidence.maintainer_signals | mcp_registry:io.github.Agent360dk/browser-mcp:1.16.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Agent360dk%2Fbrowser-mcp/versions/1.16.1 | last_activity_observed missing
## 6. security_permissions · 下游验证发现风险项
- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: 下游已经要求复核，不能在页面中弱化。
- Suggested check: 进入安全/权限治理复核队列。
- Guardrail action: 下游风险存在时必须保持 review/recommendation 降级。
- Evidence: downstream_validation.risk_items | mcp_registry:io.github.Agent360dk/browser-mcp:1.16.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Agent360dk%2Fbrowser-mcp/versions/1.16.1 | no_demo; severity=medium
## 7. security_permissions · 存在评分风险
- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: 风险会影响是否适合普通用户安装。
- Suggested check: 把风险写入边界卡，并确认是否需要人工复核。
- Guardrail action: 评分风险必须进入边界卡，不能只作为内部分数。
- Evidence: risks.scoring_risks | mcp_registry:io.github.Agent360dk/browser-mcp:1.16.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Agent360dk%2Fbrowser-mcp/versions/1.16.1 | no_demo; severity=medium
## 8. maintenance · issue/PR 响应质量未知
- Severity: low
- Evidence strength: source_linked
- Finding: issue_or_pr_quality=unknown。
- User impact: 用户无法判断遇到问题后是否有人维护。
- Suggested check: 抽样最近 issue/PR，判断是否长期无人处理。
- Guardrail action: issue/PR 响应未知时，必须提示维护风险。
- Evidence: evidence.maintainer_signals | mcp_registry:io.github.Agent360dk/browser-mcp:1.16.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Agent360dk%2Fbrowser-mcp/versions/1.16.1 | issue_or_pr_quality=unknown
## 9. maintenance · 发布节奏不明确
- Severity: low
- Evidence strength: source_linked
- Finding: release_recency=unknown。
- User impact: 安装命令和文档可能落后于代码，用户踩坑概率升高。
- Suggested check: 确认最近 release/tag 和 README 安装命令是否一致。
- Guardrail action: 发布节奏未知或过期时，安装说明必须标注可能漂移。
- Evidence: evidence.maintainer_signals | mcp_registry:io.github.Agent360dk/browser-mcp:1.16.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Agent360dk%2Fbrowser-mcp/versions/1.16.1 | release_recency=unknown