截图与PDF生成服务

为AI代理(如Claude、Cursor等)提供截图和PDF生成功能的服务器,支持通过工具调用直接捕获网页截图和生成PDF文档。

  • by Rendershot
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Rendershot/rendershot-mcp-server

使用说明

@rendershot/mcp服务器

模型上下文协议(MCP)服务器 渲染图 截图和PDF生成API。让AI代理(Claude、Cursor等)捕获屏幕截图,并直接作为工具调用生成PDF。

来源: github/渲染图/渲染图服务器

快速开始

无需安装--使用运行 npx:

RENDERSHOT_API_KEY=your_key npx @rendershot/mcp-server

Claude桌面设置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "rendershot": {
      "command": "npx",
      "args": ["-y", "@rendershot/mcp-server"],
      "env": {
        "RENDERSHOT_API_KEY": "your_api_key_here"
      }
    }
  }
}

光标/VS代码设置

添加到MCP设置中:

{
  "rendershot": {
    "command": "npx",
    "args": ["-y", "@rendershot/mcp-server"],
    "env": {
      "RENDERSHOT_API_KEY": "your_api_key_here"
    }
  }
}

环境变量

变量 必填 默认 描述
RENDERSHOT_API_KEY 是 - 您的Rendershot API密钥
RENDERSHOT_BASE_URL 没有 https://api.rendershot.io API基本URL(用于自托管的覆盖)

工具

take_screenshot

捕获URL或HTML字符串的屏幕截图。返回base64编码的图像。

参数 类型 默认值 说明
url string -- 要截图的页面URL (需要url/html之一)
html string -- 要呈现的原始HTML (需要url/html之一)
format png jpeg png
quality 1–100 85 JPEG质量(PNG忽略)
viewport_width 1–3840 1280 视口宽度(像素)
viewport_height 1–2160 720 视口高度(像素)
full_page 布尔值 false 捕获完整的可滚动页面
wait_for 字符串 dom_content_loaded load
delay_ms 0–10000 0 页面加载后的额外延迟(ms)
ai_cleanup fast thorough --
headers { [name]: value } -- 与呈现请求一起发送的自定义HTTP标头。最多30个,值≤2KB。 Host / Cookie / Content-Length / Sec-* / Connection 拒绝
cookies array -- 要注入的会话Cookie。每个需求 name, value,其中之一 domain / url.可选: path, expires, http_only, secure, same_site (Lax
basic_auth { username, password } -- HTTP基本身份验证。发送401挑战

generate_pdf

从URL或HTML字符串生成PDF。将PDF作为base64编码字符串返回。

参数 类型 默认值 说明
url string -- 页面URL (需要url/html之一)
html string -- 原始HTML (需要url/html之一)
format A3 A4 Letter
orientation portrait landscape portrait
print_background 布尔值 true 打印背景图形/颜色
wait_for 字符串 dom_content_loaded 与截图相同
delay_ms 0–10000 0 页面加载后的额外延迟(ms)
ai_cleanup fast thorough --
headers { [name]: value } -- 与截图相同
cookies array -- 与截图相同
basic_auth { username, password } -- 与截图相同

bulk_render

一次通话最多可提交20个屏幕截图或PDF作业。所有作业并行运行,结果包括每个作业的base64输出。

参数 类型 说明
jobs array(1–20) 作业对象数组,每个对象都有 type: "screenshot" 或 type: "pdf" 加上与单个工具相同的字段

返回一个JSON对象 credits_used, credits_remaining和a results 数组包含 index, result (base64),以及任何 error 每个工作。

check_balance

检查剩余API信用和计划详细信息。没有参数。

备注

  • 所有呈现调用都在内部使用异步模式并轮询,直到作业完成(最多5分钟)。
  • 截图返回MCP image 内容——代理可以内联显示它们。
  • PDF返回base64编码的文本;代理可以将它们保存到磁盘或传递。
  • API的错误(利率限制、信用耗尽、无效URL)显示为原始错误代码的MCP错误。

需求

  • Node.js 18+

许可证

麻省理工学院