ShotAPI MCP Server

io.github.smallhandsome由 GitHub 账号 smallhandsome 发布v1.0.1更新于 Oct 24, 2026

Screenshot and HTML render MCP server for AI agents

已验证Streamable HTTP可网页运行浏览器自动化开发者工具

概览

AI 生成的概览

远程 MCP 服务器，让助手对网页截图并把 HTML/CSS 渲染成图片，从而直观检查自己的输出。

可以做什么
  • 用一次调用对单个网址截图
  • 按视口、整页、CSS 选择器和格式等参数自定义截图
  • 把助手编写的 HTML/CSS 渲染成图片，便于查看并反复修改
  • 通过 HTTP 接口在部署或 CI 检查中做前后对比截图
适用场景
适合助手编写 HTML/CSS 或前端代码后需要查看渲染效果时，也适合在不本地安装浏览器环境的情况下快速目视检查已部署的页面。
运行要求
远程 streamable-http 端点，无需本地安装或 Playwright。清单声明需要 OAuth，而 README 描述的是基于 IP 的免费额度、无需注册或 API 密钥。本地 STDIO 模式需要 Python、Playwright Chromium，并可选设置 SHOTAPI_BASE_URL 和 SHOTAPI_KEY 环境变量。
安装前请注意
截图和渲染的 HTML 会发送到第三方服务，避免提交含密钥或隐私数据的页面与代码。付费套餐需要 API 密钥（SHOTAPI_KEY）并付费订阅。免费额度按 IP 计算且有限制，README 的免认证说法与清单要求的 OAuth 存在冲突。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ShotAPI MCP Server，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.smallhandsome%2Fshotapi-mcp-server/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "shotapi": {
      "type": "http",
      "url": "https://aiphotoshop.mynatapp.cc/mcp"
    }
  }
}

README

ShotAPI — Web Screenshot & Render MCP Server for AI Agents

Give your AI Agent eyes. One command, zero install.

[GitHub stars] [MCP Registry]

中文文档

Quick Start (Remote Mode — No Install)

bash
# Claude Codeclaude mcp add --transport streamable-http shotapi https://aiphotoshop.mynatapp.cc/mcp
# Or with npxnpx -y @anthropic-ai/claude-code@latest --mcp https://aiphotoshop.mynatapp.cc/mcp

For Claude Desktop / Cursor, add to your config:

json
{  "mcpServers": {    "shotapi": {      "type": "streamable-http",      "url": "https://aiphotoshop.mynatapp.cc/mcp"    }  }}

Real Use Cases

1. Claude verifies its own code

Human: Build a landing page with a hero section, testimonials, and pricing grid.
Claude: [writes HTML/CSS code]
Claude: Let me check this with the render tool...
[Claude calls ShotAPI render tool with the HTML it wrote]
Claude: The pricing grid overlaps on mobile. Fixing responsive breakpoints...

2. Deployment verification

Human: I just deployed. Check if it looks right.
Claude: [calls ShotAPI screenshot on https://yourapp.com]
Claude: Footer text is cut off — CSS overflow issue. Background image 404.

3. UI regression in CI/CD

bash
# Capture before/after screenshots and comparecurl -s "https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://staging.myapp.com" -o before.pngcurl -s "https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://staging.myapp.com" -o after.png

3 MCP Tools

ToolDescriptionExample
screenshot_one_linerOne URL, one screenshotscreenshot_one_liner(url="https://github.com")
screenshotFull control: viewport, full-page, CSS selector, formatscreenshot(url="https://github.com", selector="#hero")
renderRender HTML/CSS to image — Agent writes code, sees result instantlyrender(html="<h1>Hello</h1>")

The render tool closes the feedback loop: write code → render → see → revise → render again.

Why ShotAPI?

  • MCP-native — No glue code. Agent calls tools directly in conversation.
  • Zero install remote mode — streamable-http, no Python/Playwright needed.
  • Direct China access — No VPN required.
  • Free tier — 50 screenshots + 50 renders/month, IP-based, no signup, no API key. All features unlocked (full-page, selector, WebP).
  • Render capability — Not just screenshots of existing pages. Render Agent-generated HTML.
  • Built-in ad blocking — Cleaner screenshots, less noise.
  • Listed in MCP Registry — Official Anthropic MCP server directory.

Try It Now (No Signup)

bash
curl -s "https://aiphotoshop.mynatapp.cc/v1/screenshot?url=https://github.com" -o shot.jpg

Pricing

PlanPriceLimit
Free$050+50/month (IP-based, all features, no signup)
Starter$4.90/mo5,000/month
Pro$9.90/mo20,000/month

Free tier: no API key needed. Paid: get key at pricing page.

Local Mode (STDIO)

For private deployments or paid-tier usage, run locally:

bash
# Install dependenciespip install -r requirements.txtplaywright install chromium
# Set env varsexport SHOTAPI_BASE_URL=https://aiphotoshop.mynatapp.ccexport SHOTAPI_KEY=your_key_here  # optional for paid tiers
# Add to Claude Codeclaude mcp add shotapi python mcp_stdio.py

Links

来源：README.md，提交 09b175a

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分