비범한사람들 Chrome MCP

비범한사람들 클로드코드 실무 과정에서 쓰는 크롬 자동화 MCP입니다. 클로드코드가 내 크롬 창을 직접 열고·클릭하고·캡처합니다. 가이드: https://bibumhan-claudecode-guide.vercel.app · 문의: 비범한사람들 카카오 채널

ℹ️ ScaleMaker Chrome MCP v1.0.37 을 바탕으로 이름을 모두 BIBUMHAN 으로 새로 만든 판입니다. 확장 ID·Native host·포트(12330)가 달라서 ScaleMaker 판과 한 PC에 같이 깔려도 서로 부딪히지 않습니다. 설치 파일은 npm 이 아니라 이 저장소의 GitHub Releases 에서 받습니다 — npm 로그인·가입 필요 없음. 아래 한 줄을 통째로 복사하세요 (--allow-scripts 가 빠지면 최신 npm 에서 자동 등록이 건너뛰어집니다).

hangwin/mcp-chrome 의 reliability fork — 5+ 개월 머지 안 된 핵심 PR 7개 흡수 + Force Reconnect + Diagnostic UI. stdio transport 강제 (HTTP 12306 안 씀). 웹스토어 등록 안 함 — GitHub Release 사이드로드.

한 줄 설치

npm install -g --allow-scripts=mcp-chrome-bibumhan-bridge https://github.com/bibumhanpro/bibumhan-chrome-mcp/releases/latest/download/mcp-chrome-bibumhan-bridge.tgz

postinstall 이 자동으로 처리하는 것:

• ✅ Bridge 전역 설치

• ✅ Native Messaging manifest 등록 (com.chromemcpbibumhan.nativehost)

• ✅ Extension zip 다운로드 → ~/Downloads/mcp-chrome-bibumhan-extension-v<version>/

• ✅ Claude Code 가 설치된 경우 (~/.claude/ 존재 시) troubleshooting 스킬도 자동 설치 → ~/.claude/skills/chrome-mcp-bibumhan-doctor/SKILL.md. 이후 "MCP 안 돼" 한 마디로 Claude 가 자동 진단·복구.

Node.js 20+ 필요 — node -v 로 확인. macOS / Windows / Linux 공통.

자동 스킬 설치를 원하지 않으면: BIBUMHAN_NO_SKILL=1 npm install -g --allow-scripts=mcp-chrome-bibumhan-bridge https://github.com/bibumhanpro/bibumhan-chrome-mcp/releases/latest/download/mcp-chrome-bibumhan-bridge.tgz 사용자 custom 스킬 (frontmatter name 이 다른 경우) 은 절대 덮어쓰지 않음. 같은 스킬이 이미 있으면 bibumhan-version 비교 후 새 버전일 때만 갱신.

Related MCP server: chromeboost

남은 단계 — 2개

1. Chrome 확장 로드

chrome://extensions 열기 → 우측 상단 Developer mode ON → "Load unpacked" 클릭 → ~/Downloads/mcp-chrome-bibumhan-extension-v<version>/ 선택.

Extension ID = jcefkfpcolbkdbpgbgohgmdhkkknfhbn (모든 사용자 동일 — manifest.key 박제로 unpacked load 시에도 allowed_origins 자동 일치).

2. Claude Code 에 등록

아래 prompt 를 복사 → 터미널의 claude 에 붙여넣기. Claude Code 가 .mcp.json 에 chrome-mcp-stdio 자동 등록.

지금 working dir (이 프로젝트 폴더) 의 .mcp.json 에 우리 chrome MCP (mcp-chrome-bibumhan) 를 등록해줘. ~/.claude.json 같은 전역 설정에는 손대지 마.

규칙:
- 이름: "chrome-mcp-stdio"
- transport: stdio (HTTP 안 씀)
- command: "node"
- args: ["<npm root -g 출력값>/mcp-chrome-bibumhan-bridge/dist/mcp/mcp-server-stdio.js"]
- env: { "CHROME_PORT": "12330" }

먼저 `npm root -g` 를 bash 로 실행해서 실제 경로 얻고, 그 다음에 working dir 의 .mcp.json (없으면 신설) 의 mcpServers.chrome-mcp-stdio 만 추가/갱신해줘. 기존 다른 server 항목은 보존.

등록이 끝나면 아래 절차도 함께 안내해줘:
1. Claude Code 를 Ctrl+C 두 번으로 종료 후 다시 실행 (mcp 서버 재로드)
2. `/mcp` 입력해서 chrome-mcp-stdio 가 connected 상태인지 확인
3. 확인 후 Esc 로 빠져나오기

등록 후 Claude Code 재시작 → /mcp 로 활성 확인.

⚠️ 사이트 권한 자동 허용 — 알아두세요

이 Chrome MCP 는 AI 자동화가 끊기지 않도록 Chrome 사이트 권한 prompt 를 자동으로 처리합니다 (v1.0.32+). 두 갈래로 동작:

민감 3종 작동 방식 (camera/microphone/geolocation): AI 가 카메라/마이크/위치 정보를 쓰려고 하면 popup 토글을 확인 → 토글 ON 이면 즉시 그 사이트만 origin 단위로 영구 허용 (chrome.contentSettings.X.set({primaryPattern:'https://example.com/*', setting:'allow'})). 한 번 set 된 사이트는 브라우저 재시작 후에도 prompt 안 뜸. 사용자가 직접 chrome://settings/content/{camera,microphone,location} 갈 필요 없음.

OS 레벨 권한은 사용자 직접 설정 필요:

• macOS: 시스템 설정 > 개인정보 보호 및 보안 > 카메라/마이크/위치 서비스 → Google Chrome 토글 ON

• Windows: 설정 > 개인 정보 보호 > 카메라/마이크/위치 → Chrome 허용

• (OS 권한이 꺼져 있으면 Chrome 확장이 아무리 허용해도 디바이스/위치 접근 자체가 안 됨)

AI 자동화 흐름 confirm 게이트: popup 하단 "권한 설정" 의 토글 3개 (camera/microphone/geolocation) 는 AI 가 해당 기능을 쓸 때마다 사용자 confirm 을 받을지 결정합니다.

• Default: 토글 3개 전부 ON (install 시 초기화). 묻지 않고 즉시 사용.

• OFF 로 내리면: AI 가 해당 기능 호출 시 작은 confirm 창이 떠서 허용 여부를 묻습니다 (60초 timeout).

• 끄려면: 확장 아이콘 클릭 → popup 하단 "권한 설정" 섹션에서 토글 OFF.

보안 모델 — 비민감 4종 (popups/notifications/clipboard/autoDownload) 은 install 시 모든 사이트 일괄 허용이라 일반 사용자에게 위험할 수 있음. 민감 3종 (camera/microphone/geolocation) 은 AI 가 방문한 사이트에만 누적 추가되므로 사용자가 신뢰하지 않는 사이트엔 영향 없음 (그 사이트에 가지 않으면 추가 안 됨). 별도 Chrome 프로필 사용을 권장합니다.

opt-out: 자동 권한 세팅을 원하지 않으면 설치 후 chrome://settings/content 에서 비민감 4종을 직접 default 로 되돌리세요. 민감 3종의 origin 별 누적 허용은 chrome://settings/content/{camera,microphone,location} 에서 사이트별로 삭제 가능.

왜 fork?

(옵션) Chrome Launcher + Playwright CDP 폴백 — bibumhan-chrome CLI 가 Chrome 을 --remote-debugging-port=9222 로 띄움. native messaging 끊겨도 CDP attach 로 도구 미러. 일반 사용엔 불필요.

진단 / 트러블슈팅

설치가 꼬였다면:

mcp-chrome-bibumhan-bridge doctor          # 상태 점검
mcp-chrome-bibumhan-bridge doctor --fix    # 자동 복구
mcp-chrome-bibumhan-bridge report --copy   # 진단 리포트 (이슈 등록용)

Upstream sync

매주 자동 검사 (upstream-check.yml) + 월 1회 정기 sync. 흡수한 PR 이 upstream 머지되면 retire issue 자동 생성. 정책 → docs/UPSTREAM_SYNC.md

더 자세히

• 설계 → docs/DESIGN.md (33KB, 9 섹션)

• 흡수 PR 매트릭스 → UPSTREAM_DIFF.md

• 강제 재연결 동작 → docs/FORCE_RECONNECT.md

• 회귀 케이스 → docs/REGRESSION_CASES.md

• Playwright 폴백 → docs/PLAYWRIGHT_FALLBACK.md

License

원본 MIT — LICENSE.