Ribox MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Ribox MCP
Exact, file-based tools for AI assistants: the work a language model cannot do reliably by itself. Compress, resize and convert images, read or strip hidden metadata, make and read QR codes, count text exactly, diff text and validate JSON.
Files never leave your computer. Everything runs locally with WebAssembly codecs. No uploads, no network requests, no telemetry (the test suite checks this).
The same tools run in your browser at ribox.app.
Tools
Tool | What it does |
| Make JPEG, PNG, WebP or AVIF files smaller (HEIC/BMP input accepted); target size such as "under 200 KB", max side length, format change |
| Exact pixel sizes, fit/cover/stretch, crop, rotate 90/180/270, flip |
| HEIC, JPEG, PNG, WebP, AVIF, BMP, ICO (favicon) |
| Read EXIF / GPS / XMP / IPTC / PNG text / PDF info, or remove it without re-encoding (verified afterwards) |
| Standards-compliant QR codes (link, text, Wi-Fi, vCard, email, SMS, WhatsApp, phone, location) as PNG or SVG |
| Decode every QR code in photos or screenshots |
| Exact characters, words, sentences, lines, bytes; reading and speaking time |
| Line, word or character diff with counts and a unified diff |
| Strict validation with the exact line and column of the first error; format, minify, sort keys |
Not included on purpose: changing letter case, rewriting text and similar work an assistant already does well.
Related MCP server: Watermark & Resize Studio MCP Server
Install
Requires Node.js 22.12 or newer.
The npm package will be ribox-mcp. Until then, run it straight from this repository with npx github:AlgoWolfx/ribox-mcp. The first start downloads and builds it, which takes a minute; later starts are fast.
Claude Code
claude mcp add ribox -- npx -y github:AlgoWolfx/ribox-mcpClaude Desktop
Open Settings > Developer > Edit Config and add this to claude_desktop_config.json, then restart Claude Desktop:
{
"mcpServers": {
"ribox": {
"command": "npx",
"args": ["-y", "github:AlgoWolfx/ribox-mcp", "/path/to/allowed/folder"]
}
}
}On Windows, write the folder as "C:\\Users\\you\\Pictures".
Cursor
Add the same block to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects).
Other clients
Any MCP client that can start a stdio server works with the command npx -y github:AlgoWolfx/ribox-mcp [allowed-folder ...].
No local install? Use the remote endpoint
Assistants that cannot run local servers can connect to the remote endpoint https://ribox.app/api/mcp (Streamable HTTP). It offers only the four text tools (generate_qr, count_text, diff_text, check_json) and never accepts files. For anything that touches files, use the local server above.
Which files can it touch?
Only files inside the allowed folders:
folders given as arguments (as in the examples above), otherwise
the folders your client shares as MCP roots, otherwise
the working directory the client starts the server in.
Paths outside these folders, including ../ tricks and symbolic links that point outside, are refused.
Results are written as new files next to the input (photo.min.jpg, photo.resized.png, photo.clean.jpg) or into output_dir. An original is replaced only when you pass overwrite: true. Up to 500 files per call; folders are processed non-recursively; each file up to 200 MB.
Privacy
Your files are read and written only on your machine.
The server makes no network requests and sends no telemetry. The test suite blocks
fetch,httpandhttpsand fails if any of them is called.The only usage signal is the public npm download count (once published).
Development
git clone https://github.com/AlgoWolfx/ribox-mcp.git
cd ribox-mcp
npm install # also builds dist/
npm test # core tests + in-memory MCP client tests
npm run build
node dist/index.js --helpLayout:
src/: the MCP server (stdio transport, file sandbox, tool handlers)packages/core/: the environment-independent tool core shared with ribox.app; bundled intodist/index.jsat build timetest/: end-to-end tests with an in-memory MCP client
Issues and pull requests are welcome.
License
MIT, see LICENSE. Third-party components and their licenses (including the LGPL-3.0 HEIC decoder, used as a separate, unmodified module) are listed in THIRD_PARTY_NOTICES.md.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
PDF and image tools for AI agents: compress, merge, split, OCR, sign. Runs locally, never uploads.
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
Exact tools for AI assistants: QR codes, word counts, text diff and JSON checks. Free, no account.
File tools for your AI chat: PDF tables to Excel, merge PDFs, images to PDF, fill PDF forms.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides AI agents with local file-processing capabilities for token counting, RAG chunking, CSV/JSON conversion, QR generation, and more, while keeping documents private on the user's machine.71MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to perform local image resizing, watermarking, and EXIF/GPS metadata stripping for e-commerce and privacy compliance.318 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search and run over 500 tools for PDF, text, data, crypto, network, and conversion tasks, with file processing done locally or at the edge so inputs are not uploaded.MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to inspect, convert, resize, crop, merge, extract and OCR local images, PDFs, audio and video entirely on the user's machine. Modules can be toggled individually, and all operations stay within a sandboxed working folder with atomic writes and no data sent anywhere.2165 PyPIMIT