SammaPix — Image & PDF tools for AI agents
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http sammapix-image-pdf-tools-for-ai-agents 'https://www.sammapix.com/api/mcp'
{
"mcpServers": {
"sammapix-image-pdf-tools-for-ai-agents": {
"type": "http",
"url": "https://www.sammapix.com/api/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
SammaPix
35 free browser-based image tools — compress, convert, rename with AI, and more.
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.
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:
{
"mcpServers": {
"sammapix": { "url": "https://www.sammapix.com/api/mcp" }
}
}
Full docs, benefits, and REST examples: sammapix.com/for-ai-agents
Tools
Optimize
| Tool | Description |
|---|---|
| Compress | Reduce file size without visible quality loss |
| WebP Converter | Convert JPG/PNG to WebP for faster web delivery |
| HEIC Converter | Convert iPhone HEIC photos to JPG or PNG |
| Batch Resize | Resize multiple images by pixel dimensions or percentage |
| Crop & Ratio | Crop to standard aspect ratios or custom dimensions |
| PDF to Image | Extract pages from PDF as high-quality images |
AI-Powered
| Tool | Description |
|---|---|
| AI Organize | Drop 100+ photos — AI sorts them into named folders |
| AI Rename | Generate descriptive, SEO-friendly filenames automatically |
| AI Alt Text | Generate accessibility alt text for any image |
| AI Photo Sort | Sort photos by subject, scene, or custom criteria |
| Web Optimize | AI-assisted optimization for web performance |
| Transcribe | Extract text from images (OCR) |
Creative
| Tool | Description |
|---|---|
| Film Filters | Apply 14 analog film presets (Kodak, Fuji, Polaroid, etc.) |
| Watermark | Add text or image watermarks with custom positioning |
Organize
| Tool | Description |
|---|---|
| EXIF Viewer | Inspect full metadata — GPS, camera, exposure, timestamps |
| EXIF Remover | Strip GPS and privacy data before sharing |
| Find Duplicates | Detect duplicate images by visual similarity |
| Batch Rename | Rename files in bulk with custom patterns and sequences |
| Cull | Quickly review and select keepers from a shoot |
| Sort by Location | Group photos by GPS coordinates on an interactive map |
| Photo Map | Visualize where your photos were taken |
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 15 (App Router) |
| Language | TypeScript 5 |
| Styling | Tailwind CSS |
| State | Zustand + Immer |
| Auth | NextAuth.js v4 (Google, GitHub, Magic Link) |
| Database | Neon (PostgreSQL) via Drizzle ORM |
| AI | Google Gemini 1.5 Flash |
| Payments | Stripe |
| Resend | |
| Compression | browser-image-compression |
| HEIC | heic-convert / heic2any |
| Batch download | JSZip + file-saver |
| Testing | Playwright (E2E) |
Dashboard
AI Organize
Quick Start
git clone https://github.com/samma1997/sammapix.git
cd sammapix
npm install
cp .env.local.example .env.local # fill in your keys
npm run dev
Open http://localhost:3000.
Most tools work without any API keys — only AI features require a GEMINI_API_KEY.
Required environment variables
# Auth
NEXTAUTH_SECRET=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
# Database
DATABASE_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.
- Fork the repo
- Create a feature branch (
git checkout -b feature/your-feature) - Commit your changes
- 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
الأسئلة الشائعة
ما هو SammaPix — Image & PDF tools for AI agents؟
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
كيف أثبّت SammaPix — Image & PDF tools for AI agents؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http sammapix-image-pdf-tools-for-ai-agents 'https://www.sammapix.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج SammaPix — Image & PDF tools for AI agents إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل SammaPix — Image & PDF tools for AI agents مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون SammaPix — Image & PDF tools for AI agents؟
ينشره samma1997. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.