Install
code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'누구에게 맞나
대규모 모델이 브라우저를 조작하게 하고 싶고, 처음부터 비전 모델이 아니라 기본으로 Puppeteer의 구조화 접근성 데이터를 쓰고 싶다면 이 서버가 맞습니다. 공식은 가벼운 MCP 서비스로 적어, 모델에 브라우저 자동화 능력을 주고, 복잡한 레이아웃과 시각 요소를 위한 선택적 비전 모드도 붙입니다.
이미 Node.js 18 이상이 설치되어 있고 VS Code, Cursor, Windsurf 또는 Claude Desktop을 쓰는 사람에게 맞습니다. Node.js 18+가 없거나 클라이언트가 command 유형 MCP를 추가할 수 없다면 아직 연결하지 마세요.
읽기 전용 페이지 요약이 아닙니다. 브라우저 자동화는 브라우저를 시작하거나 연결하고, 접근성 트리를 읽으며, 비전 모드에서는 더 무거운 시각 정보도 처리할 수 있습니다. 공식은 기본으로 비전 모델이 필요 없고 주로 구조화 데이터를 소비한다고 명시하지만, 외부 네트워크와 이 기기의 브라우저 프로세스는 둘 다 있습니다.
3분 만에 첫 시도를 끝내기
공식 권장 경로는 npx로 @agent-infra/mcp-server-browser를 띄우는 것입니다. 전제 조건: 이 기기에 Node.js 18 이상이 이미 설치되어 있을 것.
VS Code에서 공식이 제시한 명령은 다음과 같습니다.
code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'
이렇게 하면 이름이 browser인 MCP가 등록되고, 명령은 npx, 인수는 @agent-infra/mcp-server-browser@latest입니다. 실행 후 클라이언트를 다시 불러오고 browser 서비스가 연결되었는지 확인하세요.
그다음 저위험 호출을 한 번 합니다. 이 browser 서비스가 제공하는 브라우저 자동화 능력을 쓰고, 기본 구조화 접근성 데이터 경로를 따르며, 비전 모드는 켜지 마세요. 공식 페이지는 구체적인 도구 이름, 매개변수, 예시 URL을 쓰지 않았으므로, 클라이언트가 이 browser 서비스에 대해 보여주는 도구만 호출하세요. 등장하지 않은 도구 이름을 스스로 만들지 말고, 열 URL도 지어내지 마세요. 성공 신호는 클라이언트가 browser가 연결되었다고 표시하고, 시각 스크린샷이 아니라 접근성 트리 기반 구조화 결과를 반환하는 것입니다.
공식에는 Cursor Settings -> MCP -> Add new MCP Server의 command 표기와 --port 8089 원격 시작도 있습니다. 첫 시도는 위의 VS Code 명령만 쓰고, 두 번째 경로를 동시에 열지 마세요.
사용 사례
사례 1: 기본 구조화 접근성 데이터로 브라우저 자동화. 공식은 Puppeteer의 구조화 접근성 데이터로 모델에 브라우저 능력을 주고, 비전 모델이 필요 없으며, 주로 구조화 데이터를 소비해 컨텍스트를 줄인다고 명시합니다. 모델이 페이지의 컨트롤과 텍스트 구조를 이해하게 하려면 이 경로를 쓰세요. 공식은 구체 도구를 지목하지 않았고 예시 사이트도 주지 않습니다. 호출 시 클라이언트가 보여주는, browser 서비스에 속한 도구만 쓰고, 성공 기준은 구조화 접근성 데이터를 받는 것으로 두세요.
사례 2: 구조화 데이터가 부족할 때 선택적 비전 모드를 검토. 공식은 비전 모드가 복잡한 레이아웃과 시각 요소용이며 선택 사항이라고 적습니다. 공식은 켜는 방법, 필요한 모델, 디스크 기록 여부를 쓰지 않았습니다. 따라서 선택적 비전 능력이 있다는 것만 확인할 수 있습니다. 첫 시도의 필수 단계로 보지 말고, 위험 제로라고 가정하지 마세요. 클라이언트에 별도 비전 스위치 설명이 없다면, 공식 페이지가 켜는 단계를 다 쓰지 않았다는 뜻입니다. 구조화 데이터 경로에 머무르세요.
사용 경계
전제는 Node.js 18+입니다. 공식이 지목한 클라이언트는 VS Code, Cursor, Windsurf, Claude Desktop입니다. 원격 시작은 npx @agent-infra/mcp-server-browser --port 8089를 쓸 수 있고, VNC나 가상 디스플레이용으로 DISPLAY=:0도 붙일 수 있습니다. 이들은 첫 시도의 주 경로가 아닙니다.
브라우저 자동화는 외부 네트워크로 나가고, 브라우저를 제어하며, 지정한 페이지를 열 수 있고, 이 기기에 탐색 흔적도 남깁니다. 선택적 비전 모드는 구조화 데이터가 부족할 때만 씁니다. 공식은 이를 네트워크 없음 또는 로컬 읽기 없음으로 쓰지 않았습니다.
공식은 속도 제한도, 실행 취소나 롤백도 쓰지 않았습니다. 브라우저 창을 닫거나 npx 프로세스를 멈추는 것이 할 수 있는 중단 방법입니다. 그러나 페이지에서 이미 일어난 이동이나 입력에 대해 공식은 원클릭 실행 취소를 주지 않습니다.