본문으로 건너뛰기
MCP 서버 전체 목록

Browser MCP

  • 추천0
  • GitHub 별7.4K
  • 개발라이선스Apache-2.0

AI 앱이 내 Chrome을 로그인 상태 그대로 쓰게 해 주는 MCP 서버. 클릭 · 입력 · 스냅샷 · 스크린샷 · PDF를 내 컴퓨터에서 처리해요

원본:BrowserMCP/mcp

설치 방법은 설치 탭에 정리했어요.

설명

Browser MCP

Browser MCP는 AI 앱(Claude Code, Cursor, VS Code, Codex, Claude Desktop 등)이 내 Chrome을 쓰게 해 줍니다. 로그인해 둔 사이트와 내 프로필을 그대로 쓰고, 에이전트는 자기 전용 탭에서 일해요. 모든 것은 내 컴퓨터에서 실행됩니다.

작동 방식

AI 앱마다 MCP 서버(npx @browsermcp/mcp@latest)를 실행합니다. 이 작은 프로세스는 사용자당 데몬을 하나 띄우고, 앱이 보낸 browser 도구 호출을 데몬에 전달해요. 데몬은 확장 프로그램을 통해 Playwright로 브라우저 탭을 조작합니다. 확장 프로그램은 chrome.debugger를 중계하는 얇은 층이라 127.0.0.1의 데몬하고만 통신하고, 컴퓨터마다 한 번 팝업에서 Allow를 눌러야 시작돼요. 이때 팝업의 여섯 자리 코드가 AI 앱이 보여 주는 코드와 같은지 확인합니다. 확장 프로그램은 데몬이 무엇을 요청하든 자기 규칙을 지킵니다. Chrome에서 확장 프로그램의 시크릿 모드에서 허용을 켜지 않으면 시크릿 탭은 쓰지 않고, 브라우저 · 확장 프로그램 페이지도 건드리지 않으며, Stop을 누르면 아무 일도 하지 않아요.

폴더패키지설명
packages/mcp@browsermcp/mcpMCP 서버와 데몬 (README)
packages/protocol@browsermcp/protocol확장 프로그램과 데몬 사이의 프로토콜(페어링 포함)
packages/extension-core@browsermcp/extension-core확장 프로그램의 브라우저 제어: 연결, 페어링, 디버거 중계, 탭 규칙, 탭 그룹, 배지
apps/extension@browsermcp/extension이 저장소에서 빌드하는 확장 프로그램: 브라우저 제어와 팝업

직접 빌드하기

Node.js 24 이상, pnpm(corepack enable), Chrome 또는 다른 Chromium 브라우저(Edge, Brave, Arc 등)가 필요해요. Firefox에는 debugger API가 없어서 Browser MCP가 동작하지 않습니다.

Chrome 웹 스토어 버전은 스스로 업데이트됩니다. 직접 불러온 빌드는 그렇지 않아서 손으로 업데이트해야 해요(아래 「업데이트」 참고).

  1. 확장 프로그램과 서버를 빌드합니다.

    git clone https://github.com/BrowserMCP/mcp.git browsermcp
    cd browsermcp
    pnpm install
    pnpm build
  2. chrome://extensions를 열고 개발자 모드를 켠 뒤 압축해제된 확장 프로그램을 로드합니다를 눌러 apps/extension/.output/chrome-mv3를 고르세요. 이름은 "Browser MCP (self-built)"입니다. 같은 프로필에 Chrome 웹 스토어의 Browser MCP가 설치돼 있으면 하나를 끄세요. 안 그러면 둘이 서버에 브라우저 두 개로 연결돼요. Browser MCP가 있는 다른 Chrome 프로필도 함께 연결되어, 에이전트가 각 프로필의 탭을 쓸 수 있습니다.

  3. AI 앱의 MCP 설정에서 npm 버전 대신 직접 빌드한 서버를 실행하세요.

    {
      "mcpServers": {
        "browsermcp": {
          "command": "node",
          "args": ["/path/to/browsermcp/packages/mcp/dist/index.js"]
        }
      }
    }

    npx @browsermcp/mcp@latest(문서의 설치 방법)도 이 확장 프로그램과 함께 동작합니다. 같은 서버를 이 저장소에서 배포한 것이니까요.

  4. AI 앱을 다시 켜고 브라우저에서 무언가를 시켜 보세요. 처음에는 확장 프로그램 팝업이 이 컴퓨터에서 서버를 Allow 할지 물어요. 팝업의 코드가 AI 앱이 보여 주는 코드와 같은지 확인하세요.

이 확장 프로그램은 빌드할 때마다 ID가 같습니다(imlplcjlhgpajopdbpbngiadkcmdbgob, apps/extension/extension-key.ts의 key에서 나옴). 서버는 Chrome 웹 스토어 ID 외에 이 ID도 받아들여요. 다른 키로 빌드했다면 그 ID를 서버 환경의 BROWSER_MCP_EXTENSION_IDS(쉼표로 구분)나 ~/.browsermcp/dev-extension-ids의 한 줄에 넣어야 합니다.

업데이트

직접 빌드한 확장 프로그램에만 해당합니다. Chrome 웹 스토어 버전은 스스로 업데이트돼요.

git pull
pnpm install
pnpm build

그런 다음 chrome://extensions에서 "Browser MCP (self-built)"의 다시 불러오기 버튼을 누르고, 이 폴더에서 서버를 실행하는 AI 앱이 있으면 다시 시작하세요. 한쪽이 너무 오래되어 다른 쪽과 맞지 않으면 확장 프로그램과 서버가 알려 줍니다.

개발

  • pnpm lint, pnpm format(pnpm format:fix로 고침): Oxlint와 Oxfmt.
  • pnpm typecheck, pnpm test: 모든 패키지의 TypeScript 검사와 단위 테스트(Vitest). 서버 테스트는 Playwright의 Chromium을 쓰므로 pnpm --filter @browsermcp/mcp exec playwright-core install chromium으로 한 번 설치하세요.
  • pnpm smoke: 개발 모드로 확장 프로그램과 서버를 빌드하고, 헤드리스 Chromium에 확장 프로그램을 불러와 AI 앱처럼 서버로 조작합니다. 무작위 포트와 임시 BROWSER_MCP_HOME을 쓰므로 내 Browser MCP는 건드리지 않아요. 스크린샷과 데몬 로그는 apps/extension/.output/smoke/에 저장되고(--out <dir>로 다른 곳에 저장, 예: 동시에 여러 번 돌릴 때), 실패한 구간은 실패한 단계나 검사, 오류, 마지막 호출의 출력을 알려 주며 열린 페이지의 스크린샷도 남겨요.
  • pnpm --filter @browsermcp/extension build:dev: 개발용 빌드(apps/extension/.output/chrome-mv3-dev).

기여와 보안

버그 보고와 변경 제안 방법은 CONTRIBUTING.md를, 취약점을 비공개로 알리는 방법은 SECURITY.md를 보세요.

라이선스

Apache-2.0. 나나 우리 팀이 쓰려고 빌드하는 것은 괜찮고, 내 도구가 Browser MCP와 호환된다거나 그 코드를 바탕으로 만들었다고 밝히는 것도 괜찮습니다. 수정한 확장 프로그램이나 서버를 공개한다면(브라우저 확장 스토어, npm 등 다른 사람이 설치하는 곳 어디든) 다른 이름과 아이콘을 쓰고, 공식 Browser MCP이거나 공식 인증을 받은 것처럼 보이게 하지 마세요. 그래야 사람들이 둘을 구분할 수 있어요. LICENSE를 유지하고 무엇을 바꿨는지 밝혀 주세요.

서버 도구 (@browsermcp/mcp)

서버는 browser 도구 하나를 제공합니다. 한 번 호출에 명령을 한 줄씩 여러 개 보내면 첫 오류에서 멈추고, 동작은 ✓ 한 줄로, 읽기 명령은 결과를 출력해요. 대상(target)은 스냅샷 참조(e12), getByRole('button', { name: 'Go' }), getByLabel / getByText / getByPlaceholder('…'), CSS 선택자로 지정합니다.

구분명령
이동goto <url>, back, forward, reload
조작click, fill, type, press, select, check, uncheck, hover, drag, scroll, upload, dialog
대기wait <ms>, wait --text, wait --url 등
탭tab list, tab new, tab select, tab close
읽기snapshot, find, get, screenshot, pdf, download, eval, console, requests, request

저장소: BrowserMCP/mcp