npm shotpipe-mcpstdioupdated 1mo ago
Hosted, SSRF-safe, cached screenshots and Open Graph images for AI agents — no headless Chrome to run.
O que dá para fazer com Shotpipe — Screenshots & OG Images?
shotpipe-mcp
Hosted, SSRF-safe, cached screenshots and Open Graph images for AI agents — no headless Chrome to run.
An MCP server that lets an agent screenshot any URL and see the result, or mint a social-card image, by calling Shotpipe. It's the thing a local browser tool can't be:
- No Chrome in your agent's sandbox. Rendering happens on Shotpipe's infrastructure. Nothing to install, no memory to babysit, no OOM at 2am.
- Safe on untrusted URLs. Agents point at URLs their users typed. Shotpipe resolves DNS itself, pins the IP, re-checks every redirect, and refuses private / loopback / cloud-metadata hosts — so a hostile link can't turn your renderer into an SSRF hole.
- Cached. The first capture renders; every identical one after is served from the edge in milliseconds and costs nothing.
Ad and cookie-consent banners are stripped by default.
Install
// 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"
}
}
}
}
Get a free key at shotpipe.io/signup (no card) or run npx shotpipe-init. Self-hosting Shotpipe? Set SHOTPIPE_BASE_URL.
Tools
screenshot
Screenshot a URL and return the image (so the model can see it) plus a permanent, shareable signed URL.
url (required) · format png|jpeg|pdf · width · height · dpr · full_page · selector · dark · omit_background · block_ads · block_banners · wait_for · delay · quality · fresh
og_image
Build a signed social-card URL from a hosted template. Returns the URL only by default and renders nothing — the image renders lazily on the first crawler hit, so agent/build time stays fast. Drop it into <meta property="og:image">. Pass render: true to also get a preview image.
title (required) · template · author · tag · accent · logo · width · height · dpr · render
How it works
The signing secret never leaves the process — every request is HMAC-signed locally, exactly like Shotpipe's other clients. The server just builds a signed URL and (for screenshot) fetches the bytes.
MIT · shotpipe.io
Instalação
Adicione Shotpipe — Screenshots & OG Images ao seu cliente. Escolha o que você usa.
claude mcp add shotpipe-mcp -- npx -y shotpipe-mcpcodex mcp add shotpipe-mcp -- npx -y shotpipe-mcpamp mcp add shotpipe-mcp -- npx -y shotpipe-mcp{
"mcpServers": {
"shotpipe-mcp": {
"command": "npx",
"args": [
"-y",
"shotpipe-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"shotpipe-mcp": {
"command": "npx",
"args": [
"-y",
"shotpipe-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"shotpipe-mcp","command":"npx","args":["-y","shotpipe-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"shotpipe-mcp": {
"command": "npx",
"args": [
"-y",
"shotpipe-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"shotpipe-mcp": {
"command": "npx",
"args": [
"-y",
"shotpipe-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"shotpipe-mcp": {
"command": "npx",
"args": [
"-y",
"shotpipe-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"shotpipe-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"shotpipe-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"shotpipe-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"shotpipe-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y shotpipe-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Pontuação
39 / 100
Incompleta
- Documentação22/25
- Manutenção16/25
- Confiança6/20
- Capacidade0/15
- Instalação12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 39 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Histórico de versões
| Versões | Publicada |
|---|---|
| 0.1.1Mais recente | 23 de jul. de 2026 |