Spronta

io.github.spronta由 GitHub 账号 spronta 发布v0.1.3更新于 Nov 3, 2026

Upload, transform, and deliver images on a global CDN via AI agents.

发布方自己的服务:Crawlie

概览

AI 生成的概览

Spronta 的 MCP 服务器让助手在全局图片 CDN 上上传图片、应用变换、管理预设与签名 URL,并查看用量。

可以做什么
  • 管理项目:列出、创建、查看含用量统计的详情、更新与删除图片项目
  • 上传与管理图片:从 URL 或 base64 上传,列出、修改替代文本与标签、删除
  • 创建和维护命名变换预设,用于缩放、裁剪、格式转换、智能裁剪与 blurhash
  • 配置 HMAC-SHA256 URL 签名,并生成可设置过期时间的签名 CDN 链接
  • 查看每日用量指标,并在不调用 API 的情况下构建带变换参数的 CDN 链接
适用场景
适合希望助手在对话中直接为网站或应用发布和优化图片的场景:上传素材、生成不同尺寸或 WebP/AVIF 版本、建立可复用预设,以及为私有图片签发带有效期的链接。
运行要求
以 stdio 在本地运行,通常通过 npx @spronta/mcp 启动,需要 Node.js。需要 Spronta 账号和项目;API 密钥通过 SPRONTA_API_KEY 传入,可选 SPRONTA_PROJECT_ID 与 SPRONTA_API_URL。需要能访问 Spronta API 及图片来源的网络。
安装前请注意
SPRONTA_API_KEY 中的 API 密钥可访问该项目的图片与设置,请勿放入共享配置。相关工具可创建、修改并永久删除项目、图片和预设,也可启用或关闭 URL 签名。上传会抓取你提供的图片 URL,并将其发送到 Spronta 的存储与 CDN。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spronta,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@spronta/mcp

MCP server for uploading, transforming, and serving images on a global CDN — directly from AI assistants.

Connect Claude, GPT, Cursor, Windsurf, or any MCP-compatible client to the Spronta Image CDN. Upload images from URLs or base64, apply real-time transforms (resize, crop, format conversion, smart crop, blurhash), create reusable presets, generate signed URLs, and monitor usage — all through natural language.

Why use this?

  • Upload images from AI — give your LLM an image URL and it uploads, optimizes, and returns a CDN link
  • Real-time transforms — resize, crop, convert to WebP/AVIF/JXL, smart crop with face detection
  • Global CDN delivery — images served from edge locations worldwide
  • Blurhash generation — automatic blur placeholders computed on upload
  • Signed URLs — HMAC-SHA256 signed URLs with expiration for private images
  • Named presets — create reusable transform configurations (e.g. thumbnail, hero, og-image)
  • No vendor lock-in — MIT licensed, open source

Quick start

Install

bash
npm install -g @spronta/mcp# or use directlynpx @spronta/mcp

Claude Code

bash
claude mcp add spronta \  -e SPRONTA_API_KEY=spronta_img_... \  -e SPRONTA_PROJECT_ID=your-project-id \  -- npx @spronta/mcp

Claude Desktop / Cursor / Windsurf

Add to your MCP configuration file:

json
{  "mcpServers": {    "spronta": {      "command": "npx",      "args": ["@spronta/mcp"],      "env": {        "SPRONTA_API_KEY": "spronta_img_...",        "SPRONTA_PROJECT_ID": "your-project-id"      }    }  }}

Get your API key

  1. Sign up at app.spronta.com (free tier: 100 images)
  2. Create a project in the dashboard
  3. Copy your API key from project settings

Environment variables

VariableRequiredDescription
SPRONTA_API_KEYYesYour project API key
SPRONTA_PROJECT_IDNoDefault project ID (can also be passed per-tool)
SPRONTA_API_URLNoAPI base URL (default: https://app.spronta.com/api)

18 tools available

Projects

ToolDescription
list_projectsList all image projects
create_projectCreate a new project
get_projectGet project details with usage stats
update_projectUpdate name or custom domain
delete_projectPermanently delete a project

Upload & Images

ToolDescription
upload_imageUpload from URL or base64 — handles presigned upload, blurhash generation, and CDN URL creation in one call
list_imagesList images with pagination
update_imageUpdate alt text and tags
delete_imageDelete an image from CDN and storage

Transform Presets

ToolDescription
list_presetsList named transform presets
create_presetCreate a preset (use in CDN URLs with ?t=name)
update_presetUpdate a preset's name or transforms
delete_presetDelete a preset

URL Signing

ToolDescription
get_signing_configGet URL signing configuration
update_signingEnable/disable HMAC-SHA256 signing
generate_signed_urlGenerate a signed CDN URL with optional expiration

Analytics & Utility

ToolDescription
get_usageGet daily metrics (requests, bandwidth, transforms)
build_cdn_urlBuild a CDN URL with transform parameters (no API call)

Example prompts

Once connected, just ask your AI:

> Upload this image to my project: https://example.com/photo.jpg
> Create a thumbnail preset: 200x200, cover crop, face detection, webp format
> How many requests did my project handle this week?
> Generate a signed URL for hero.jpg that expires in 1 hour
> List all my images and update the alt text on the product shots
> Build a CDN URL for banner.png at 1200px wide in avif format

Transform options

When creating presets or building URLs, these transforms are available:

ParameterTypeDescription
widthintegerOutput width (1–8192)
heightintegerOutput height (1–8192)
fitstringcover, contain, fill, scale-down, crop, pad
formatstringauto, webp, avif, jpeg, png, jxl
qualityinteger1–100
qualityModestringhigh, medium, low (perceptual targeting)
gravitystringauto, face, center, position keywords
blurintegerGaussian blur (1–250)
sharpennumberUnsharp mask (0–10)
radiusintegerCorner radius (1–9999, or "max" for circle)
grayscalebooleanConvert to grayscale
brightnessinteger-100 to 100
contrastnumber-100 to 100
saturationinteger-100 to 100
sepiabooleanSepia tone filter
rotateinteger90, 180, 270
flipstringh (horizontal), v (vertical)

How upload works

The upload_image tool handles the full upload pipeline in a single call:

  1. You provide an image URL (or base64 data) and a filename
  2. The server fetches the image
  3. Requests a presigned upload URL from Spronta
  4. Uploads the file directly to storage
  5. Confirms the upload — Spronta computes the blurhash and detects dimensions
  6. Returns the confirmed image with CDN URL, blurhash, and metadata

Related packages

Links

License

MIT

来源:README.md,提交 0d70c36

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

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

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

其他 Crawlie 集成