mcpField
S
Shotpipe — Screenshots & OG Images

Shotpipe — Screenshots & OG Images

本地服务
shotpipe.io浏览器自动化014 周前更新
代码仓库访问官网

关于 Shotpipe — Screenshots & OG Images

Shotpipe MCP 是一个托管截图与 Open Graph 图片服务的 MCP 服务，供 AI Agent 截取 URL 页面并获取图像，或生成社交卡片链接。它在 Shotpipe 基础设施上渲染，支持缓存，并对不可信 URL 实施 SSRF 防护。

主要功能

  1. 01将网页截图作为图像返回
  2. 02生成签名社交卡片 URL
  3. 03支持多种截图格式与页面选项
  4. 04缓存截图结果
  5. 05默认移除广告和 Cookie 同意横幅

适用场景

  1. 01让 Agent 查看指定网页的渲染结果
  2. 02为网页或构建流程生成社交卡片链接
  3. 03在处理用户提供的 URL 时获取截图

MCP 相关

该 MCP 服务向客户端开放 screenshot 和 og_image 工具。它请求 Shotpipe 托管服务渲染页面，并返回截图图像或签名图片 URL。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "podop29-shotpipe": {
      "command": "npx",
      "args": [
        "-y",
        "shotpipe-mcp"
      ],
      "env": {
        "SHOTPIPE_KEY": "<SHOTPIPE_KEY>",
        "SHOTPIPE_SECRET": "<SHOTPIPE_SECRET>",
        "SHOTPIPE_BASE_URL": "<SHOTPIPE_BASE_URL>"
      }
    }
  }
}
启动命令npx -y shotpipe-mcp
需要配置的环境变量
SHOTPIPE_KEY密钥Shotpipe API key id (starts with k_). Free at https://shotpipe.io/signup.
SHOTPIPE_SECRET密钥Shotpipe HMAC signing secret. Requests are signed locally; the secret never leaves the process.
SHOTPIPE_BASE_URLOverride the API base URL for a self-hosted Shotpipe instance. Defaults to https://shotpipe.io.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmshotpipe-mcp0.1.1

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
dprenum否设备像素比（视网膜屏幕）。默认值为 1。1 | 2 | 3
urlstring是要截取的页面 URL（http/https）。
darkboolean否模拟 prefers-color-scheme: dark。
delayinteger否截取前额外等待的时间，单位为 ms。
freshboolean否绕过缓存并强制重新渲染。
widthinteger否视口宽度，单位为 px。默认值为 1200。
formatenum否输出格式。默认值为 png。png | jpeg | pdf
heightinteger否视口高度，单位为 px。默认值为 630。
qualityinteger否JPEG 质量，范围为 1–100（仅适用于 format=jpeg）。
selectorstring否CSS 选择器——将截图裁剪为该元素。
wait_forstring否等待此 CSS 选择器对应的元素出现后再截图。
block_adsboolean否拦截广告和跟踪器请求。默认值为 true。
full_pageboolean否截取整个可滚动页面，而不仅是视口。
block_bannersboolean否隐藏 Cookie 同意横幅。默认值为 true。
omit_backgroundboolean否使用透明背景（仅限 png）。

详细介绍

shotpipe-mcp

为 AI Agent 提供托管式、SSRF 安全且带缓存的截图和 Open Graph 图片——无需运行无头 Chrome。

一个 MCP 服务，让 Agent 通过调用 Shotpipe 对任意 URL 截图并查看结果，或生成社交卡片图片。这正是本地浏览器工具无法做到的：

  • Agent 的沙箱中无需安装 Chrome。 渲染在 Shotpipe 的基础设施上完成。无需安装任何东西，无需操心内存，也不会在凌晨 2 点发生内存溢出。
  • 访问不可信 URL 也安全。 Agent 会访问用户输入的 URL。Shotpipe 会自行解析 DNS、固定 IP、重新检查每次重定向，并拒绝私有网络、环回地址和云元数据主机——因此恶意链接无法让你的渲染器成为 SSRF 漏洞入口。
  • 带缓存。 首次请求会进行渲染；此后每个相同请求都会从边缘节点在毫秒内返回，且不产生费用。

默认会移除广告和 Cookie 同意横幅。

安装

// Claude Desktop (claude_desktop_config.json), Claude Code (.mcp.json),
// Cursor, Cline, or any MCP client:
{
  "mcpServers": {
    "shotpipe": {
      "command": "npx",
      "args": ["-y", "shotpipe-mcp"],
      "env": {
        "SHOTPIPE_KEY": "k_your_key",
        "SHOTPIPE_SECRET": "your_signing_secret"
      }
    }
  }
}

在 shotpipe.io/signup 免费获取密钥（无需信用卡），或运行 npx shotpipe-init。如果自行托管 Shotpipe，请设置 SHOTPIPE_BASE_URL。

工具

screenshot

为 URL 截图并返回图片（供模型查看），以及一个永久、可分享的签名 URL。

url（必填） · format png|jpeg|pdf · width · height · dpr · full_page · selector · dark · omit_background · block_ads · block_banners · wait_for · delay · quality · fresh

og_image

根据托管模板生成签名的社交卡片 URL。默认仅返回URL，不进行渲染——图片会在爬虫首次访问时延迟渲染，因此不会拖慢 Agent 或构建速度。将其放入 <meta property="og:image">。传入 render: true 还可获取预览图片。

title（必填） · template · author · tag · accent · logo · width · height · dpr · render

工作原理

签名密钥不会离开进程——每个请求都会像 Shotpipe 的其他客户端一样在本地进行 HMAC 签名。服务只负责构建签名 URL，并在使用 screenshot 时获取字节数据。

MIT · shotpipe.io

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。