극작가 MCP 서버 가져오기

Name: Playwright Fetch MCP Server
Author: ThreatFlux

GitHub 릴리스(날짜별 최신) 씨아이 코드코브 라이센스: MIT 파이썬 버전 극작가 엠씨피 코드 스타일: 검정색

Playwright를 사용하여 브라우저 자동화를 위한 웹 콘텐츠 가져오기 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 웹 페이지에서 JavaScript로 렌더링된 콘텐츠를 검색하고 처리하며, HTML을 마크다운으로 변환하여 더 쉽게 사용할 수 있습니다.

작가

Wyatt Roersma 가 Claude Code의 도움을 받아 제작했습니다.

Related MCP server: MCP Playwright CDP

주요 특징

브라우저 자동화 : Playwright를 사용하여 JavaScript를 완벽하게 지원하여 웹 페이지를 렌더링합니다.
콘텐츠 추출 : 웹 페이지에서 주요 콘텐츠 영역을 자동으로 식별하고 추출합니다.
마크다운 변환 : HTML을 깔끔하고 읽기 쉬운 마크다운으로 변환합니다.
페이지 매김 지원 : 페이지 매김을 통해 대용량 콘텐츠를 처리합니다.
Robots.txt 준수 : 자율적 페칭을 위해 robots.txt 지침을 준수합니다.
프록시 지원 : 프록시 서버를 통해 라우팅 요청을 허용합니다.
Docker Ready : Docker Hub 및 GitHub Container Registry를 통해 미리 빌드된 Docker 이미지로 사용 가능

사용 가능한 도구

playwright-fetch - Playwright 브라우저 자동화를 사용하여 URL을 가져오고 해당 내용을 마크다운으로 추출합니다.
- url (문자열, 필수): 가져올 URL
- max_length (정수, 선택 사항): 반환할 최대 문자 수(기본값: 5000)
- start_index (정수, 선택 사항): 이 문자 인덱스에서 시작 콘텐츠(기본값: 0)
- raw (부울, 선택 사항): 마크다운 변환 없이 원시 콘텐츠를 가져옵니다(기본값: false)
- wait_for_js (부울, 선택 사항): JavaScript가 실행될 때까지 기다립니다(기본값: true)

프롬프트

극작가-페치
- Playwright를 사용하여 URL을 가져오고 해당 내용을 마크다운으로 추출합니다.
- 인수:
  - url (문자열, 필수): 가져올 URL

요구 사항

Python 3.13.2 이상
uv 패키지 관리자
Playwright 브라우저 설치됨

설치

1. uv로 설치하기 (권장)

지엑스피1

또는 저장소를 복제하고 설치하세요.

git clone https://github.com/ThreatFlux/playwright-fetch.git cd playwright-fetch uv pip install -e . # Install Playwright browsers uv pip exec playwright install

2. Docker 사용하기

Docker Hub 또는 GitHub Container Registry에서 미리 작성된 Docker 이미지를 사용할 수 있습니다.

# From Docker Hub docker pull threatflux/playwright-fetch:latest # From GitHub Container Registry docker pull ghcr.io/threatflux/playwright-fetch:latest

아니면 직접 만들어 보세요:

docker build -t threatflux/playwright-fetch .

구성

Claude.app에 대한 구성

Claude 설정에 추가:

"mcpServers": { "playwright-fetch": { "command": "uvx", "args": ["mcp-server-playwright-fetch"] } }

"mcpServers": { "playwright-fetch": { "command": "docker", "args": ["run", "-i", "--rm", "threatflux/playwright-fetch"] } }

VS Code에 대한 구성

수동 설치의 경우 VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가합니다.

{ "mcp": { "servers": { "playwright-fetch": { "command": "uvx", "args": ["mcp-server-playwright-fetch"] } } } }

{ "mcp": { "servers": { "playwright-fetch": { "command": "docker", "args": ["run", "-i", "--rm", "threatflux/playwright-fetch"] } } } }

명령줄 옵션

서버는 다음과 같은 명령줄 옵션을 지원합니다.

--user-agent : 사용자 정의 사용자 에이전트 문자열
--ignore-robots-txt : robots.txt 제한을 무시합니다.
--proxy-url : 요청에 사용할 프록시 URL
--headless : 브라우저를 헤드리스 모드로 실행합니다(기본값: True)
--wait-until : 탐색이 성공한 것으로 간주할 시점(선택 사항: "load", "domcontentloaded", "networkidle", "commit", 기본값: "networkidle")

사용 예

# Run with default settings uv run mcp-server-playwright-fetch # Run with a custom user agent and proxy uv run mcp-server-playwright-fetch --user-agent="MyCustomAgent/1.0" --proxy-url="http://myproxy:8080" # Run with visible browser for debugging uv run mcp-server-playwright-fetch --headless=false