Screenshot Scout

Máy chủ MCP Screenshot Scout

Sử dụng Screenshot Scout từ máy khách MCP để chụp các trang web HTTP hoặc HTTPS dưới dạng hình ảnh hoặc PDF.

Máy chủ này cung cấp một công cụ, capture_screenshot. Công cụ này hỗ trợ chụp toàn trang và chụp phần tử, điều khiển thiết bị và khung nhìn, chọn vị trí, tùy chọn tương tác và chặn trang, kích thước và chất lượng hình ảnh, bố cục PDF, bộ nhớ đệm, URL kết quả tạm thời và nội dung hình ảnh MCP đủ điều kiện.

Bạn cần chuẩn bị gì

• Một tài khoản Screenshot Scout và một khóa truy cập từ trang khóa API.
• Node.js 22 trở lên để cài đặt npm/stdio. Môi trường chạy MCPB của Claude Desktop được đi kèm với Claude.
• Khóa bí mật tùy chọn chỉ khi khóa API bạn chọn yêu cầu yêu cầu Screenshot Scout có chữ ký.

Mỗi lần chụp sử dụng tài khoản Screenshot Scout của bạn và phải tuân theo gói, hạn mức và giới hạn tốc độ của tài khoản.

Stdio cục bộ với npm

Bắt đầu với cấu hình stdio cục bộ này:

{
  "mcpServers": {
    "screenshotscout": {
      "command": "npx",
      "args": ["-y", "@screenshotscout/mcp"],
      "env": {
        "SCREENSHOTSCOUT_ACCESS_KEY": "YOUR_ACCESS_KEY"
      }
    }
  }
}

Nếu khóa truy cập yêu cầu ký yêu cầu, hãy thêm khóa bí mật cục bộ:

"SCREENSHOTSCOUT_SECRET_KEY": "YOUR_SECRET_KEY"

Giữ các tệp cấu hình cá nhân ngoài kiểm soát nguồn. Thông tin xác thực là các giá trị môi trường của tiến trình, không phải đối số công cụ. Xem cấu hình sao chép-dán theo từng máy khách cho Claude Desktop, Claude Code, Cursor, VS Code/GitHub Copilot, Devin và Cline.

Chạy từ bản kiểm tra mã nguồn

npm ci
npm run build

Trỏ máy khách đến đường dẫn tuyệt đối tới dist/stdio.js với node và cung cấp các biến môi trường giống như hiển thị ở trên.

Claude Desktop MCPB

Để cài đặt tiện ích mở rộng Claude Desktop:

1. Tải xuống screenshotscout-mcp-<version>.mcpb từ bản phát hành GitHub của phiên bản đó.
2. Trong Claude Desktop, mở Settings → Extensions → Advanced settings và chọn Install Extension….
3. Chọn tệp đã tải xuống.
4. Nhập khóa truy cập bắt buộc. Chỉ nhập khóa bí mật cho khóa API yêu cầu yêu cầu có chữ ký.

Claude Desktop coi cả hai trường là cài đặt nhạy cảm. MCPB v0.1.0 hỗ trợ Windows.

HTTP Streamable được lưu trữ

Điểm cuối khóa API được lưu trữ đang hoạt động tại:

https://mcp.screenshotscout.com/mcp/api-key

Điểm cuối này chỉ dành cho các máy khách có thể đính kèm tiêu đề HTTP tĩnh:

Authorization: Bearer YOUR_ACCESS_KEY

Điểm cuối chỉ chấp nhận khóa truy cập. Không bao giờ gửi khóa bí mật Screenshot Scout đến điểm cuối này và không bao giờ đặt bất kỳ khóa nào trong URL hoặc đối số công cụ. Các máy khách không thể đính kèm tiêu đề Bearer tĩnh không thể sử dụng điểm cuối này.

Các khóa API yêu cầu chữ ký yêu cầu phải sử dụng stdio cục bộ hoặc MCPB, hoặc sử dụng khóa truy cập không ký chuyên dụng cho điểm cuối được lưu trữ.

Stdio cục bộ với Docker

Xây dựng hình ảnh sản xuất từ bản kiểm tra mã nguồn:

docker build --tag screenshotscout-mcp:local .

Chuyển thông tin xác thực từ môi trường cục bộ và giữ stdin được đính kèm cho lưu lượng stdio MCP:

docker run --rm -i --init --cap-drop=ALL --security-opt=no-new-privileges --read-only \
  -e SCREENSHOTSCOUT_ACCESS_KEY \
  -e SCREENSHOTSCOUT_SECRET_KEY \
  screenshotscout-mcp:local

SCREENSHOTSCOUT_SECRET_KEY vẫn là tùy chọn. Hình ảnh chạy với tư cách người dùng không có đặc quyền và chỉ chứa máy chủ stdio đã biên dịch cùng các phụ thuộc sản xuất của nó. Hình ảnh không khai báo cổng hoặc kiểm tra sức khỏe vùng chứa: máy khách MCP sở hữu tiến trình stdio và xác minh trạng thái sẵn sàng bằng cách hoàn tất khởi tạo MCP. Hình ảnh và siêu dữ liệu Docker MCP Catalog của nó trong docker-mcp-catalog.yaml là chuẩn bị cục bộ; không có hình ảnh công khai nào được ngụ ý bởi các lệnh này.

Công cụ: capture_screenshot

capture_screenshot gửi một yêu cầu chụp cho URL và các tùy chọn được cung cấp. Trang web mục tiêu là bên ngoài và nội dung trả về của nó phải được coi là không đáng tin cậy.

Đầu vào

Chỉ url là bắt buộc. Chụp sử dụng khung nhìn 1280×720 theo mặc định. Khi không chỉ định định dạng, công cụ trả về JPEG ở chất lượng 60. resultMode mặc định là "auto".

Nhóm	Đầu vào
Mục tiêu và đầu ra	url; format (png, jpg, jpeg, webp, gif, tiff, pdf); resultMode (auto, url_only)
Vị trí và khung nhìn	country (mã quốc gia hai chữ cái), device, deviceViewportWidth, deviceViewportHeight, colorScheme (auto, dark, light), fullPage
Chuẩn bị trang	blockCookieBanners, blockAds, blockChatWidgets, selector, hideSelectors, clickSelectors
Thời gian	waitUntil (load, domcontentloaded, networkidle0, networkidle2), delay (0–30 giây), navigationTimeout (5–90 giây), timeout (1–240 giây)
Bộ nhớ đệm	cache, cacheTtl (14.400–2.592.000 giây)
Thay đổi kích thước đầu ra	imageWidth, imageHeight (1–8.192; khả dụng cho hình ảnh và PDF)
Chỉ hình ảnh	imageQuality (0–100, chỉ JPEG/WebP)
Chỉ PDF	pdfPaperFormat (letter, legal, tabloid, a4, a3, content), pdfLandscape, pdfPrintBackground, pdfMargin, các trường lề mỗi cạnh, pdfScale (lớn hơn 0 và tối đa 3)

Khi cả hai kích thước đầu ra được cung cấp, tích của chúng không được vượt quá 64.000.000 pixel. Lề PDF chấp nhận giá trị không âm ở px, in, mm hoặc cm. imageQuality yêu cầu đầu ra JPEG hoặc WebP và các tùy chọn chỉ PDF yêu cầu format: "pdf".

Kết quả

• PNG, JPEG, WebP và GIF có thể được bao gồm dưới dạng nội dung hình ảnh MCP khi resultMode là auto, loại MIME đủ điều kiện, kích thước được biết và tối đa 8.000 pixel mỗi cạnh, dữ liệu thô tối đa 5 MiB và kết quả tuần tự hóa hoàn chỉnh phù hợp với giới hạn máy chủ 128.000 byte hiện tại.
• Bản chụp không đủ điều kiện để nhúng vẫn thành công và trả về URL tạm thời cùng lý do bỏ qua có thể thực hiện được.
• TIFF chỉ có URL.
• Byte PDF không bao giờ được nhúng. Kết quả PDF bao gồm văn bản an toàn và siêu dữ liệu có cấu trúc, cùng với liên kết tài nguyên khi Screenshot Scout cung cấp URL kết quả.
• resultMode: "url_only" bỏ qua byte hình ảnh cho mọi định dạng.

Các máy khách MCP kiểm soát việc nội dung hình ảnh hoặc liên kết tài nguyên trả về được hiển thị hay được cung cấp cho mô hình.

Siêu dữ liệu có cấu trúc có thể bao gồm screenshotUrl, screenshotUrlExpiresAt, cacheStatus, format, mimeType, imageWidth, imageHeight, inlineImageIncluded và inlineImageOmissionReason.

Hãy coi URL kết quả là các liên kết nhạy cảm, tạm thời và tôn trọng thời hạn hết hạn được báo cáo của chúng.

Ví dụ về lời nhắc

• "Chụp https://example.com dưới dạng PNG toàn trang ở chế độ tối. Chỉ trả về URL."
• "Chụp ảnh màn hình JPEG 1280×720 của https://example.com/pricing, chặn biểu ngữ cookie và quảng cáo, và dùng chất lượng 80."
• "Tạo PDF A4 của https://example.com/report với nền được bật và lề 10 mm."

Quyền riêng tư và bảo mật

Máy chủ gửi URL mục tiêu và các tùy chọn chụp đã chọn đến Screenshot Scout, dịch vụ này sẽ tải trang web mục tiêu. Hãy xem lại chính sách quyền riêng tư của Screenshot Scout trước khi chụp tài liệu riêng tư hoặc được quản lý.

• Không chụp các trang bạn không được phép truy cập.
• Không dán thông tin xác thực vào lời nhắc, đầu vào công cụ, URL, báo cáo sự cố hoặc nhật ký.
• Giữ khóa truy cập và khóa bí mật cục bộ trong kho lưu trữ bí mật do máy khách quản lý hoặc cấu hình môi trường riêng tư.
• Máy chủ stdio cục bộ không thêm telemetry. Ghi nhật ký ứng dụng cho dịch vụ được lưu trữ chỉ giới hạn ở phương thức yêu cầu, trạng thái phản hồi, thời lượng và lỗi bất ngờ đã được làm sạch. Nhật ký được thiết kế để không bao gồm thông tin xác thực, URL mục tiêu, URL ảnh chụp màn hình, nội dung yêu cầu hoặc phản hồi hoặc byte hình ảnh.
• Xem xét từng mục tiêu và yêu cầu chụp trước khi cho phép sử dụng công cụ. Công cụ là thế giới mở, tiêu thụ hạn mức và tương tác với trang web bên ngoài.
• Báo cáo lỗ hổng một cách riêng tư như mô tả trong SECURITY.md.

Phát triển

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test
npm run metadata:check
npm run registry:validate
npm run mcpb:validate
npm run mcpb:pack

Giấy phép

MIT © Oleksii Velykyi