Configurable Puppeteer MCP Server
구성 가능한 Puppeteer MCP 서버
Puppeteer를 사용하여 브라우저 자동화 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 설정 가능한 옵션이 있습니다. 이 서버를 통해 LLM은 실제 브라우저 환경에서 웹 페이지와 상호 작용하고, 스크린샷을 찍고, JavaScript를 실행할 수 있으며, 환경 변수를 통해 Puppeteer 실행 옵션을 사용자 지정할 수 있습니다.
구성 요소
도구
꼭두각시 조종자_탐색
브라우저에서 모든 URL로 이동합니다.
입력:
url(문자열)
인형극단 스크린샷
전체 페이지 또는 특정 요소의 스크린샷을 캡처합니다.
입력:
name(문자열, 필수): 스크린샷의 이름selector(문자열, 선택 사항): 스크린샷을 찍을 요소에 대한 CSS 선택기width(숫자, 선택 사항, 기본값: 800): 스크린샷 너비height(숫자, 선택 사항, 기본값: 600): 스크린샷 높이
꼭두각시_클릭
페이지의 요소를 클릭하세요
입력:
selector(문자열): 클릭할 요소에 대한 CSS 선택기
인형극 배우기_호버
페이지에 요소 올려놓기
입력:
selector(문자열): 호버할 요소에 대한 CSS 선택기
인형극_채우기
입력 필드를 작성하세요
입력:
selector(문자열): 입력 필드에 대한 CSS 선택기value(문자열): 채울 값
꼭두각시 선택
SELECT 태그로 요소를 선택하세요
입력:
selector(문자열): 선택할 요소에 대한 CSS 선택기value(문자열): 선택할 값
인형극 평가자
브라우저 콘솔에서 JavaScript 실행
입력:
script(문자열): 실행할 JavaScript 코드
자원
서버는 두 가지 유형의 리소스에 대한 액세스를 제공합니다.
콘솔 로그 (
console://logs)텍스트 형식의 브라우저 콘솔 출력
브라우저의 모든 콘솔 메시지를 포함합니다.
스크린샷 (
screenshot://<name>)캡처된 스크린샷의 PNG 이미지
캡처 중에 지정된 스크린샷 이름을 통해 접근 가능
Related MCP server: Steel Puppeteer
주요 특징
브라우저 자동화
콘솔 로그 모니터링
스크린샷 기능
JavaScript 실행
기본 웹 상호작용(탐색, 클릭, 양식 작성)
환경 변수를 통한 구성 가능한 Puppeteer 옵션
구성
사용자 정의 퍼펫티어 옵션과 함께 사용
PUPPETEER_ARGS 환경 변수에 JSON 문자열을 제공하여 Puppeteer 실행 옵션을 구성할 수 있습니다. 이를 통해 서버 코드를 수정하지 않고도 브라우저 동작을 사용자 지정할 수 있습니다.
예: Chrome 대신 Firefox 사용
지엑스피1
예: 브라우저 창 크기 구성
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"],
"env": {
"PUPPETEER_ARGS": "{\"defaultViewport\": {\"width\": 1280, \"height\": 800}}"
}
}
}
}표준 구성
엔피엑스
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer"]
}
}
}또한 브랜치, 태그 또는 커밋을 지정할 수도 있습니다.
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": ["-y", "github:afshawnlotfi/mcp-configurable-puppeteer#main"]
}
}
}특허
이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.
Available Tools
7 toolspuppeteer_clickC
Click an element on the page
Inputs: selector (required).
puppeteer_evaluateB
Execute JavaScript in the browser console
Inputs: script (required).
puppeteer_fillC
Fill out an input field
Inputs: selector (required), value (required).
puppeteer_hoverC
Hover an element on the page
Inputs: selector (required).
puppeteer_screenshotB
Take a screenshot of the current page or a specific element
Inputs: name (required), selector, width, height.
puppeteer_selectC
Select an element on the page with Select tag
Inputs: selector (required), value (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Every tool has a clearly distinct purpose with no ambiguity. Clicking, evaluating JavaScript, filling inputs, hovering, navigating, taking screenshots, and selecting dropdown elements are all separate browser automation operations that an agent can easily distinguish. The descriptions clearly differentiate each action.
All tools follow a perfect verb_noun pattern with consistent snake_case naming (puppeteer_click, puppeteer_evaluate, etc.). The 'puppeteer_' prefix creates a clear namespace, and the action verbs (click, evaluate, fill, hover, navigate, screenshot, select) are consistently descriptive and parallel in structure.
Seven tools is well-scoped for a Puppeteer automation server. This provides core browser interaction capabilities without being overwhelming. Each tool earns its place by covering essential operations like navigation, interaction, evaluation, and capture that form a complete automation workflow.
The toolset covers most essential Puppeteer operations well, including navigation, interaction, evaluation, and screenshots. Minor gaps exist - there's no explicit tool for waiting/loading states, keyboard input, or cookie/session management - but agents can work around these using evaluate or other tools. Core browser automation workflows are well-supported.
Maintenance
Related MCP Connectors
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud browser, web extraction, screenshots, and remote CDP tools for AI agents.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.19Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs to automate web browsers using Puppeteer, allowing navigation, screenshots, form filling, and JavaScript execution in a real browser environment.2MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that provides browser automation capabilities using Puppeteer, enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.71MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages, take screenshots, generate test code, scrape web content, and execute JavaScript in real browser environments.31MIT