강철 인형사
Puppeteer와 Steel을 사용하여 브라우저 자동화 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 실제 브라우저 환경에서 웹 페이지와 상호 작용하고, 스크린샷을 찍고, JavaScript를 실행할 수 있습니다.
구성 요소
도구
꼭두각시 조종자_탐색
브라우저에서 모든 URL로 이동합니다.
입력:
url(문자열, 필수): 이동할 URLtimeout(숫자, 선택 사항, 기본값: 60000): 탐색 시간 초과(밀리초)waitUntil(문자열, 선택 사항, 기본값: "domcontentloaded"): 탐색이 성공한 것으로 간주할 시점. 옵션: "load", "domcontentloaded", "networkidle0", "networkidle2"
인형극단 스크린샷
전체 페이지 또는 특정 요소의 스크린샷을 캡처합니다.
입력:
name(문자열, 필수): 스크린샷의 이름selector(문자열, 선택 사항): 스크린샷을 찍을 요소에 대한 CSS 선택기
꼭두각시_클릭
페이지의 요소를 클릭하세요
입력:
selector(문자열, 필수): 클릭할 요소에 대한 CSS 선택기
인형극_채우기
입력 필드를 작성하세요
입력:
selector(문자열, 필수): 입력 필드에 대한 CSS 선택기value(문자열, 필수): 채울 값
꼭두각시 선택
SELECT 태그로 요소를 선택하세요
입력:
selector(문자열, 필수): 선택할 요소에 대한 CSS 선택기value(문자열, 필수): 선택할 값
인형극 배우기_호버
페이지에 요소 올려놓기
입력:
selector(문자열, 필수): 호버할 요소에 대한 CSS 선택기
인형극 평가자
브라우저 콘솔에서 JavaScript 실행
입력:
script(문자열, 필수): 실행할 JavaScript 코드
퍼펫티어_겟_콘텐츠
현재 페이지에서 콘텐츠 추출
입력:
selector(문자열, 선택 사항): 특정 요소에서 콘텐츠를 가져오는 CSS 선택자입니다. 지정하지 않으면 전체 페이지 콘텐츠를 반환합니다.
인형극 스크롤
페이지를 스크롤하여 지연 로딩을 트리거합니다.
입력:
scrollDelay(숫자, 선택 사항, 기본값: 100): 스크롤 간 지연 시간(밀리초)maxScrolls(숫자, 선택 사항, 기본값: 50): 스크롤의 최대 수
자원
서버는 두 가지 유형의 리소스에 대한 액세스를 제공합니다.
콘솔 로그 (
console://logs)텍스트 형식의 브라우저 콘솔 출력
브라우저의 모든 콘솔 메시지를 포함합니다.
스크린샷 (
screenshot://<name>)캡처된 스크린샷의 PNG 이미지
캡처 중에 지정된 스크린샷 이름을 통해 접근 가능
Related MCP server: Puppeteer MCP Server
주요 특징
Puppeteer를 사용한 브라우저 자동화
브라우저 세션 관리를 위한 Steel 통합
콘솔 로그 모니터링 및 캡처
스크린샷 기능
JavaScript 실행
기본 웹 상호작용(탐색, 클릭, 양식 작성)
토큰 제한 처리를 통한 콘텐츠 추출
스크롤을 통한 레이지 로딩 지원
로컬 및 원격 Steel 인스턴스 지원
구성
클로드 데스크톱 구성
Claude Desktop과 함께 Steel Puppeteer 서버를 사용하려면 다음 구성을 Claude Desktop 구성 파일(macOS에서는 일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있음)에 추가하세요.
지엑스피1
"path/to/steel-puppeteer/dist/index.js" 시스템에 있는 컴파일된 JavaScript 파일의 실제 경로로 바꾸세요.
환경 변수
Steel Puppeteer 서버는 다음 환경 변수를 사용하여 구성할 수 있습니다.
STEEL_LOCAL(선택 사항, 기본값: "false"): 클라우드 서비스 대신 로컬 Steel 인스턴스를 사용하려면 "true"로 설정합니다.STEEL_API_KEY(STEEL_LOCAL이 "false"인 경우에만 필요): 클라우드 서비스를 사용할 때 인증을 위한 Steel API 키입니다.STEEL_URL(선택 사항): 사용자 정의 배포를 사용하는 경우 Steel 인스턴스의 URL입니다.
서버 구성
Steel Puppeteer 서버를 Claude Desktop을 통하지 않고 직접 실행하는 경우, 셸에서 이러한 환경 변수를 설정하거나 프로젝트 루트에 .env 파일을 생성할 수 있습니다. 로컬에서 사용할 수 있는 .env 파일의 예는 다음과 같습니다.
Steel 클라우드 서비스를 사용하는 경우 .env 파일은 다음과 같습니다.
서버 실행
Steel Puppeteer 서버를 시작하려면:
종속성 설치:
npm install프로젝트를 빌드하세요:
npm run build서버를 시작합니다:
npm startClaude Desktop을 열고 탐색해 보세요! 서버가 시작되어 지정된 포트(기본값: 3000)에서 수신 대기합니다.
문제 해결
Puppeteer에 문제가 발생하면 시스템에 필요한 종속성이 설치되어 있는지 확인하세요. 자세한 내용은 Puppeteer 문제 해결 가이드를 참조하세요.
Steel 클라우드 서비스를 사용하는 경우 Steel API 키가 유효하고 필요한 권한이 있는지 확인하세요.
로컬 Steel 인스턴스를 사용하는 경우 지정된 URL(사용자 지정 시) 또는 기본 로컬 주소에서 실행 중이고 액세스 가능한지 확인하세요.
더 자세한 구성 옵션과 고급 사용법에 대해서는 Steel 설명서와 Puppeteer API 참조를 참조하세요.