Community生产力与协作github.com

carlos19772023/mcp-server-website

📸 高效捕获高质量网页截图,自动切片以优化AI工作流中的处理。

mcp-server-website 是什么?

此技能基于 MCP (Model Context Protocol) 服务器,让 AI 代理(如 Claude Code, Cursor 等)能够高效地捕获网页的完整截图。它特别针对 AI 工作流进行了优化:当网页较长时,会自动将截图分割成多个切片,确保每张图片尺寸合理,便于 AI 模型处理和分析。支持自定义截图宽度和视口高度,并能将截图保存到指定目录或返回 Base64 编码的数据。这解决了直接输出超大截图导致 AI 处理失败的问题,是开发文档、UI 测试、内容监控等场景下的必备工具。无需复杂配置,只需运行 MCP 客户端并提供目标 URL 即可。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add carlos19772023/mcp-server-website

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

mcp-server-website 是做什么的?

📸 高效捕获高质量网页截图,自动切片以优化AI工作流中的处理。

功能

  • 通过 MCP 协议捕获网页截图
  • 自动将长图切割为多个切片(默认高度 4096px)
  • 支持自定义截图宽度(默认 1200px)
  • 支持自定义视口高度(默认 4096px)
  • 可保存截图到指定目录或返回 Base64 数据
  • 配置简单,即插即用

安装

npm install -g @modelcontextprotocol/server-website
# 或者
npx @modelcontextprotocol/server-website

配置

在 MCP 客户端配置文件中添加:

{
  "mcpServers": {
    "website": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-website"],
      "env": {
        "SAVE_DIR": "./screenshots"
      }
    }
  }
}

使用

通过 MCP 工具调用:

  • capture_screenshot:捕获指定 URL 的截图
    • url(必填):目标网页地址
    • width(可选):截图宽度,默认 1200
    • viewportHeight(可选):视口高度,默认 4096
    • fullPage(可选):是否截取整页,默认 true
    • save(可选):是否保存到本地文件,默认 false

示例

# 通过 MCP 客户端调用
tool_result = await client.call_tool("website", {
  "url": "https://example.com",
  "width": 1440,
  "fullPage": true
})

输出

  • 返回截图文件路径或 Base64 编码数据
  • 自动切片后返回多个截图片段
  • 每个切片附带原始 URL 和切片索引

环境变量

变量名说明默认值
SAVE_DIR截图保存目录./screenshots
SLICE_HEIGHT切片高度(px)4096
DEFAULT_WIDTH默认截图宽度1200

相关技能