SammaPix — Image & PDF tools for AI agents

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

Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.

已验证Streamable HTTP可网页运行文件与存储媒体与设计

概览

AI 生成的概览

远程 MCP 服务器,用于图像与 PDF 处理:压缩、转换、缩放、裁剪、加水印、查看元数据,并可在一次调用中串联多个操作。

可以做什么
  • 压缩、转换(WebP、HEIC)、缩放、裁剪、旋转、翻转、调色、模糊、着色、加边框或水印,以及读取或清除元数据
  • 压缩、合并、拆分、旋转 PDF,图片转 PDF,以及把 PDF 页面导出为图片
  • 用 AI 生成文件名、替代文本、照片分类,以及从图片中提取文字(OCR)
  • 在一次流水线调用中串联多个图像操作,减少往返次数
适用场景
适合助手需要为网页准备、压缩或转换图片与 PDF,批量处理照片,或在不搭建本地工具链的情况下生成替代文本和文件名的场景。
运行要求
远程 Streamable HTTP 端点(sammapix.com),需要 OAuth 2.1 登录(也可改用生成的 REST 密钥)。无需本地安装或环境变量。
安装前请注意
AI 功能会把图片的小缩略图发送给 Google Gemini 分析。按次计费,每天 25 次免费操作,并提供 Pro 套餐。官方称零留存,但文件仍需离开本机才能到达远程服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SammaPix — Image & PDF tools for AI agents,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

{
  "mcpServers": {
    "sammapix-image-pdf-tools-for-ai-agents": {
      "type": "http",
      "url": "https://www.sammapix.com/api/mcp"
    }
  }
}

README

SammaPix

35 free browser-based image tools — compress, convert, rename with AI, and more.

[MIT License] [Next.js] [TypeScript] [Live Site] [Build]


SammaPix is a free, open-source image optimization platform that runs entirely in the browser. No uploads. No account required. No watermarks. Your images never leave your device.

Built for content creators, developers, and anyone who works with images at scale.

[SammaPix — AI Photo Workflow]

Key features:

  • 100% client-side processing — images stay on your machine
  • 35 tools across four categories (optimize, AI, creative, organize)
  • AI-powered rename, alt text generation, and photo sorting via Google Gemini
  • Batch processing with ZIP download
  • HEIC, WebP, PDF, and video format support
  • Dark mode, fully responsive
  • Pro plan ($9/month) for unlimited AI credits and larger batches

For AI agents (MCP server)

SammaPix is also a remote MCP server so AI agents (Claude, Cursor, and any MCP-compatible client) can run real image & PDF processing directly — no local install.

  • Endpoint: https://www.sammapix.com/api/mcp (Streamable HTTP)
  • Auth: OAuth 2.1 — no API key to paste. Or generate a key for REST.
  • 20+ tools: compress, convert, resize, crop, rotate, flip, adjust, grayscale, blur, tint, negate, border, round, watermark, metadata · PDF compress/merge/split/rotate, image-to-PDF, PDF info
  • Pipeline: chain multiple image ops in one call — fewer round-trips, far fewer tokens for the agent
  • Zero-retention: files processed in memory and discarded. Pay-per-use, 25 free ops/day.

Add it to your agent:

json
{  "mcpServers": {    "sammapix": { "url": "https://www.sammapix.com/api/mcp" }  }}

Full docs, benefits, and REST examples: sammapix.com/for-ai-agents


Tools

Optimize

ToolDescription
CompressReduce file size without visible quality loss
WebP ConverterConvert JPG/PNG to WebP for faster web delivery
HEIC ConverterConvert iPhone HEIC photos to JPG or PNG
Batch ResizeResize multiple images by pixel dimensions or percentage
Crop & RatioCrop to standard aspect ratios or custom dimensions
PDF to ImageExtract pages from PDF as high-quality images

AI-Powered

ToolDescription
AI OrganizeDrop 100+ photos — AI sorts them into named folders
AI RenameGenerate descriptive, SEO-friendly filenames automatically
AI Alt TextGenerate accessibility alt text for any image
AI Photo SortSort photos by subject, scene, or custom criteria
Web OptimizeAI-assisted optimization for web performance
TranscribeExtract text from images (OCR)

Creative

ToolDescription
Film FiltersApply 14 analog film presets (Kodak, Fuji, Polaroid, etc.)
WatermarkAdd text or image watermarks with custom positioning

Organize

ToolDescription
EXIF ViewerInspect full metadata — GPS, camera, exposure, timestamps
EXIF RemoverStrip GPS and privacy data before sharing
Find DuplicatesDetect duplicate images by visual similarity
Batch RenameRename files in bulk with custom patterns and sequences
CullQuickly review and select keepers from a shoot
Sort by LocationGroup photos by GPS coordinates on an interactive map
Photo MapVisualize where your photos were taken

Tech Stack

LayerTechnology
FrameworkNext.js 15 (App Router)
LanguageTypeScript 5
StylingTailwind CSS
StateZustand + Immer
AuthNextAuth.js v4 (Google, GitHub, Magic Link)
DatabaseNeon (PostgreSQL) via Drizzle ORM
AIGoogle Gemini 1.5 Flash
PaymentsStripe
EmailResend
Compressionbrowser-image-compression
HEICheic-convert / heic2any
Batch downloadJSZip + file-saver
TestingPlaywright (E2E)

[27 Free Tools]

Dashboard [SammaPix Dashboard]
AI Organize [AI Organize Tool]

Quick Start

bash
git clone https://github.com/samma1997/sammapix.gitcd sammapixnpm installcp .env.local.example .env.local   # fill in your keysnpm run dev

Open http://localhost:3000.

Most tools work without any API keys — only AI features require a GEMINI_API_KEY.

Required environment variables

bash
# AuthNEXTAUTH_SECRET=GOOGLE_CLIENT_ID=GOOGLE_CLIENT_SECRET=
# DatabaseDATABASE_URL=          # Neon PostgreSQL connection string
# AI (required for AI tools only)GEMINI_API_KEY=
# Payments (required for Pro plan only)STRIPE_SECRET_KEY=STRIPE_WEBHOOK_SECRET=NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=STRIPE_PRO_PRICE_ID=
NEXT_PUBLIC_APP_URL=http://localhost:3000

Privacy

All image processing tools run entirely in your browser using the Canvas API, WebAssembly, and client-side JavaScript libraries. Your images are never uploaded to any server.

For AI tools (AI Rename, AI Alt Text, AI Organize), a small thumbnail is sent to Google Gemini for analysis. Full-resolution originals never leave your device and are never stored anywhere.


Contributing

Contributions are welcome. Please open an issue before submitting a pull request for significant changes.

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/your-feature)
  3. Commit your changes
  4. Open a pull request

For bug reports and feature requests, use GitHub Issues.


License

MIT — see LICENSE for details.


Built by Luca Sammarco · Live at sammapix.com

来源:README.md,提交 ef30f3d

工具

0
该服务器需要登录,因此 SourceWeft 无法在没有账号的情况下读取其工具,也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.0.0最新Sep 20, 2026

评分

已满足适用检查项的 85%

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

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

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

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