cloudflare-browser-rendering-mcp
Cloudflare 브라우저 렌더링 MCP 서버
이 MCP(모델 컨텍스트 프로토콜) 서버는 LLM에서 컨텍스트로 사용할 웹 콘텐츠를 Cloudflare 브라우저 렌더링을 사용하여 가져오고 처리하는 도구를 제공합니다. Claude 및 Cline 클라이언트 환경 모두에서 작동하도록 설계되었습니다.
특징
웹 콘텐츠 가져오기 : LLM 컨텍스트에 대한 웹 페이지 가져오기 및 처리
문서 검색 : Cloudflare 문서를 검색하고 관련 콘텐츠를 반환합니다.
구조화된 콘텐츠 추출 : CSS 선택기를 사용하여 웹 페이지에서 구조화된 콘텐츠 추출
콘텐츠 요약 : 보다 간결한 LLM 컨텍스트를 위해 웹 콘텐츠를 요약합니다.
스크린샷 캡처 : 웹 페이지의 스크린샷을 찍습니다
Related MCP server: turbowebfetch
필수 조건
Node.js v18 이상
브라우저 렌더링 API 액세스가 가능한 Cloudflare 계정
제공된
puppeteer-worker.js파일을 사용하여 배포된 Cloudflare Worker
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 Cloudflare Browser Rendering을 자동으로 설치하려면 다음을 수행합니다.
지엑스피1
이 저장소를 복제하세요:
git clone https://github.com/yourusername/cloudflare-browser-rendering.git cd cloudflare-browser-rendering종속성 설치:
npm install프로젝트를 빌드하세요:
npm run build
Cloudflare Worker 설정
Wrangler를 사용하여 Cloudflare Workers에
puppeteer-worker.js파일을 배포합니다.npx wrangler deployCloudflare Worker에서 다음 바인딩을 구성해야 합니다.
브라우저 렌더링 바인딩은
browser라는 이름으로 지정됩니다.KV 네임스페이스 바인딩이
SCREENSHOTS로 명명됨
배포된 작업자의 URL을 기록해 두세요(예:
https://browser-rendering-api.yourusername.workers.dev)
구성
클로드 데스크탑용
Claude Desktop 구성 파일을 엽니다.
# macOS code ~/Library/Application\ Support/Claude/claude_desktop_config.json # Windows code %APPDATA%\Claude\claude_desktop_config.jsonMCP 서버 구성을 추가합니다.
{ "mcpServers": { "cloudflare-browser-rendering": { "command": "node", "args": ["/path/to/cloudflare-browser-rendering/dist/index.js"], "env": { "BROWSER_RENDERING_API": "https://your-worker-url.workers.dev" }, "disabled": false, "autoApprove": [] } } }Claude Desktop을 다시 시작하세요
클라인을 위해
Cline MCP 설정 파일을 엽니다.
# macOS code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json # Windows code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.jsonMCP 서버 구성을 추가합니다.
{ "mcpServers": { "cloudflare-browser-rendering": { "command": "node", "args": ["/path/to/cloudflare-browser-rendering/dist/index.js"], "env": { "BROWSER_RENDERING_API": "https://your-worker-url.workers.dev" }, "disabled": false, "autoApprove": [] } } }
용법
MCP 서버를 구성하면 Claude Desktop과 Cline 모두에서 사용할 수 있습니다. 다음 도구를 사용할 수 있습니다.
페치_페이지
LLM 컨텍스트에 대한 웹 페이지를 가져와서 처리합니다.
매개변수:
url(필수): 가져올 URLmaxContentLength(선택 사항): 반환할 최대 콘텐츠 길이
예:
Can you fetch and summarize the content from https://developers.cloudflare.com/browser-rendering/?검색_문서
Cloudflare 문서를 검색하여 관련 콘텐츠를 반환합니다.
매개변수:
query(필수): 검색어maxResults(선택 사항): 반환할 최대 결과 수
예:
Search the Cloudflare documentation for information about "browser rendering API".구조화된 콘텐츠 추출
CSS 선택기를 사용하여 웹 페이지에서 구조화된 콘텐츠를 추출합니다.
매개변수:
url(필수): 콘텐츠를 추출할 URLselectors(필수): 콘텐츠를 추출하는 CSS 선택자
예:
Extract the main heading and first paragraph from https://developers.cloudflare.com/browser-rendering/ using the selectors h1 and p.요약_내용
보다 간결한 LLM 맥락을 위해 웹 콘텐츠를 요약합니다.
매개변수:
url(필수): 요약할 URLmaxLength(선택 사항): 요약의 최대 길이
예:
Summarize the content from https://developers.cloudflare.com/browser-rendering/ in 300 words or less.스크린샷 찍기
웹 페이지의 스크린샷을 찍습니다.
매개변수:
url(필수): 스크린샷을 찍을 URLwidth(선택 사항): 픽셀 단위의 뷰포트 너비(기본값: 1280)height(선택 사항): 픽셀 단위의 뷰포트 높이(기본값: 800)fullPage(선택 사항): 전체 페이지의 스크린샷을 찍을지 아니면 뷰포트만 찍을지(기본값: false)
예:
Take a screenshot of https://developers.cloudflare.com/browser-rendering/ with a width of 1024 pixels.문제 해결
벌채 반출
MCP 서버는 다음 접두사를 사용하여 포괄적인 로깅을 사용합니다.
[Setup]: 초기화 및 설정[API]: API 요청 및 응답[Error]: 오류 처리 및 디버깅
로그를 보려면:
Claude Desktop :
~/Library/Logs/Claude/mcp*.log(macOS) 또는%APPDATA%\Claude\Logs\mcp*.log(Windows)에서 로그를 확인하세요.Cline : 로그가 VSCode 확장 프로그램의 출력 콘솔에 나타납니다.
일반적인 문제
"BROWSER_RENDERING_API 환경 변수가 설정되지 않았습니다"
MCP 서버 구성에서 Cloudflare Worker에 올바른 URL을 설정했는지 확인하세요.
"Cloudflare Worker API를 사용할 수 없거나 구성되지 않았습니다."
Cloudflare Worker가 배포되어 실행 중인지 확인하세요.
URL이 올바르고 접근 가능한지 확인하세요
"브라우저 바인딩을 사용할 수 없습니다"
Cloudflare Worker에서 브라우저 렌더링 바인딩을 구성했는지 확인하세요.
"스크린샷 KV 바인딩을 사용할 수 없습니다"
Cloudflare Worker에서 KV 네임스페이스 바인딩을 구성했는지 확인하세요.
개발
프로젝트 구조
src/index.ts: 메인 진입점src/server.ts: MCP 서버 구현src/browser-client.ts: Cloudflare 브라우저 렌더링과 상호 작용하기 위한 클라이언트src/content-processor.ts: LLM 컨텍스트에 대한 웹 콘텐츠를 처리합니다.puppeteer-worker.js: Cloudflare Worker 구현
건물
npm run build테스트
이 프로젝트에는 모든 MCP 도구가 올바르게 작동하는지 확인하는 포괄적인 테스트 스크립트가 포함되어 있습니다.
npm test이렇게 하면:
MCP 서버를 시작합니다
샘플 요청으로 각 도구를 테스트하세요
응답을 확인하세요
테스트 결과 요약을 제공하세요
특정 구성 요소에 대해 개별 테스트를 실행할 수도 있습니다.
# Test the Puppeteer integration
npm run test:puppeteer테스트가 제대로 작동하려면 다음 사항이 있는지 확인하세요.
npm run build로 프로젝트를 빌드했습니다.BROWSER_RENDERING_API환경 변수를 Cloudflare Worker URL로 설정하세요.필요한 바인딩으로 Cloudflare Worker를 배포했습니다.
특허
MIT
Available Tools
5 toolsextract_structured_contentC
Extracts structured content from a web page using CSS selectors
Inputs: selectors (required), url (required).
fetch_pageC
Fetches and processes a web page for LLM context
Inputs: url (required), maxContentLength.
search_documentationC
Searches Cloudflare documentation and returns relevant content
Inputs: query (required), maxResults.
summarize_contentC
Summarizes web content for more concise LLM context
Inputs: url (required), maxLength.
take_screenshotB
Takes a screenshot of a web page and returns it as an image
Inputs: url (required), fullPage, height, width.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: extract_structured_content targets specific elements, fetch_page retrieves full pages, search_documentation queries documentation, summarize_content condenses content, and take_screenshot captures visual output. An agent can easily differentiate between these functions.
All tools follow a consistent verb_noun pattern with snake_case naming (e.g., extract_structured_content, fetch_page, search_documentation). This uniformity makes the toolset predictable and easy to understand for an agent.
With 5 tools, this server is well-scoped for browser rendering and content processing tasks. Each tool earns its place by covering distinct aspects like fetching, extracting, searching, summarizing, and screenshotting, without being overly sparse or bloated.
The toolset covers core browser rendering workflows (fetching, extracting, summarizing, screenshotting) and includes a domain-specific search function. A minor gap exists in advanced interactions like form submission or navigation, but agents can work around this for most use cases.
Maintenance
Related MCP Connectors
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Web scraping MCP server: any URL to Markdown or JSON, with JavaScript rendering and batch jobs.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server that provides LLMs with stealth browser automation capabilities via CloakBrowser to bypass bot detection services like Cloudflare and reCAPTCHA. It supports full page interaction, content extraction, and human-like behavior through 30 specialized tools.2040 PyPI14Apache 2.0
- AlicenseAqualityBmaintenanceMCP server that lets Claude Code fetch web content using real Chrome browsers. Renders JavaScript-heavy pages, handles bot mitigation, and runs up to 14 parallel browsers locally with zero API keys. Makes outbound HTTP requests only to URLs the user explicitly asks Claude to fetch.214 npm91MIT
- FlicenseNot gradedqualityDmaintenanceA remote MCP server deployable on Cloudflare Workers without authentication, providing tools for website scraping and content extraction using Cloudflare's Browser Rendering and AI.1-
- AlicenseCqualityDmaintenanceAn MCP server that gives Claude Code real browser control for web automation, testing, and screenshots.3246 npm158MIT