spronta

@spronta/mcp

用于通过全球 CDN 上传、转换和提供图像的 MCP 服务 — 直接通过 AI 助手操作。

将 Claude、GPT、Cursor、Windsurf 或任何兼容 MCP 的客户端连接到 Spronta 图像 CDN。通过自然语言从 URL 或 base64 上传图像、应用实时转换（调整大小、裁剪、格式转换、智能裁剪、blurhash）、创建可复用预设、生成签名 URL 并监控用量。

为什么使用它？

• 通过 AI 上传图像 — 提供图像 URL，大模型即可上传并优化图像，然后返回 CDN 链接
• 实时转换 — 调整大小、裁剪、转换为 WebP/AVIF/JXL，或通过人脸检测进行智能裁剪
• 全球 CDN 分发 — 图像由全球各地的边缘节点提供
• 生成 Blurhash — 上传时自动计算模糊占位图
• 签名 URL — 使用 HMAC-SHA256 生成带过期时间的签名 URL，保护私有图像
• 命名预设 — 创建可复用的转换配置（例如 thumbnail、hero、og-image）
• 无厂商锁定 — 采用 MIT 许可的开源软件

快速开始

安装

npm install -g @spronta/mcp
# or use directly
npx @spronta/mcp

Claude Code

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

Claude Desktop / Cursor / Windsurf

添加到 MCP 配置文件：

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

获取 API 密钥

1. 在 app.spronta.com 注册（免费套餐：100 张图像）
2. 在控制面板中创建项目
3. 从项目设置中复制 API 密钥

环境变量

变量	必需	说明
SPRONTA_API_KEY	是	项目 API 密钥
SPRONTA_PROJECT_ID	否	默认项目 ID（也可按工具传入）
SPRONTA_API_URL	否	API 基础 URL（默认值：https://app.spronta.com/api）

提供 18 个工具

项目

工具	说明
list_projects	列出所有图像项目
create_project	创建新项目
get_project	获取项目详情和用量统计
update_project	更新名称或自定义域名
delete_project	永久删除项目

上传与图像

工具	说明
upload_image	从 URL 或 base64 上传 — 一次调用即可处理预签名上传、生成 blurhash 并创建 CDN URL
list_images	分页列出图像
update_image	更新替代文本和标签
delete_image	从 CDN 和存储中删除图像

转换预设

工具	说明
list_presets	列出命名转换预设
create_preset	创建预设（在 CDN URL 中通过 ?t=name 使用）
update_preset	更新预设名称或转换配置
delete_preset	删除预设

URL 签名

工具	说明
get_signing_config	获取 URL 签名配置
update_signing	启用/禁用 HMAC-SHA256 签名
generate_signed_url	生成带可选过期时间的签名 CDN URL

分析与实用工具

工具	说明
get_usage	获取每日指标（请求数、带宽、转换次数）
build_cdn_url	使用转换参数构建 CDN URL（不调用 API）

示例提示词

连接后，直接向 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

转换选项

创建预设或构建 URL 时，可使用以下转换选项：

参数	类型	描述
width	integer	输出宽度（1–8192）
height	integer	输出高度（1–8192）
fit	string	cover、contain、fill、scale-down、crop、pad
format	string	auto、webp、avif、jpeg、png、jxl
quality	integer	1–100
qualityMode	string	high、medium、low（感知质量优化）
gravity	string	auto、face、center、位置关键词
blur	integer	高斯模糊（1–250）
sharpen	number	反遮罩锐化（0–10）
radius	integer	圆角半径（1–9999，或使用 "max" 创建圆形）
grayscale	boolean	转换为灰度图
brightness	integer	-100 至 100
contrast	number	-100 至 100
saturation	integer	-100 至 100
sepia	boolean	棕褐色调滤镜
rotate	integer	90、180、270
flip	string	h（水平）、v（垂直）

上传工作原理

upload_image 工具通过一次调用完成整个上传流程：

1. 提供图片 URL（或 base64 数据）和文件名
2. 服务获取图片
3. 向 Spronta 请求预签名上传 URL
4. 将文件直接上传到存储空间
5. 确认上传 — Spronta 会计算 blurhash 并检测尺寸
6. 返回已确认的图片，其中包含 CDN URL、blurhash 和元数据

相关软件包

• @spronta/images — 核心 URL 构建器 SDK（零依赖）
• @spronta/images-react — React 组件
• @spronta/images-next — Next.js 集成
• WordPress 插件 — 为 WordPress 自动配置 CDN

链接

• 网站
• 文档
• API 参考
• OpenAPI 规范
• GitHub
• npm

许可证

MIT