Samurai Knife MCP Server
Allows the CV studio to draft showcase project entries from GitHub repositories, enabling agents to pull repository information into CV profiles.
Provides tools for building and validating MongoDB queries within the NoSQL/vector lab, helping agents construct database queries with docs-derived validation.
Provides tools for building and validating Redis queries within the NoSQL/vector lab, helping agents construct database queries with docs-derived validation.
Provides tools for SQL lab operations, including formatting, transpiling between dialects, validating, building from JSON, schema checks, and running SQLite in the browser.
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.
Smart Knife
Stop paying for software that spies on you: office documents, photo and video editing, PDF tools and a CV builder in your browser, free.
The big proprietary suites are expensive, locked down and full of terms nobody reads; they push your files into their cloud and spy on what you do. Smart Knife puts free tools and open-source apps for the same work on one website you can use or run yourself. It has a step-by-step welcome guide and CV wizard for people who are not computer savvy, plus 41 tools (31 suites with 107 tabs, plus 10 standalone), an optional AI assistant that drives the live page, and an MCP endpoint for outside agents (Claude Code, Cursor, OpenClaw…). No telemetry and no ads, and most tools never send a byte off the page.
Instead of paying for | Use, free | For |
Subscription office suites | Euro-Office | documents, spreadsheets and slides (DOCX, XLSX, PPTX) |
Subscription photo programs | PhotoCraft, LightCraft | photo editing and RAW development |
Subscription design programs | VectorCraft, DesignCraft | graphics and page layout |
Subscription video and audio programs | FilmCraft, EffectCraft, SoundCraft | video, effects and sound |
Expensive PDF editors | PDF tools, PdfCraft | editing, merging, compressing and OCR for PDFs |
Paid CV websites | CV builder | a CV in Polish and English, in PDF or DOCX, adjusted to each job offer |
Pay-per-task automation services | Automations | connecting apps and running tasks by themselves |
Euro-Office and the Craft apps are other people's open-source projects. We only host them, and are not affiliated with their authors: they do not endorse us and we do not endorse them. They cover everyday and much advanced work, not every feature of the paid programs.

|
|
|
|
What's inside
Everyday tools, grouped by the job you're doing rather than by file type:
Data: JSON workbench (lint, JSONPath, diagram, schema), CSV workbench (convert, columns, merge, pivot, profile, duplicates, compare, Markdown tables), YAML/XML, QR codes
Databases: SQL lab (format, transpile between dialects, validate, schema checks, run SQLite in the browser, connection strings); agents also get MongoDB, Chroma and Redis query tools over MCP
Documents: PDF toolkit (merge, split, compress, protect, an in-browser editor, OCR in English and Polish, searchable-PDF export), Markdown
Images: export and resize, metadata scrubbing, responsive sets and favicons, crop and trim, pixel compare, an SVG workshop
Web and code: a website check (a live URL: redirects, security headers, cookies, SEO, accessibility, robots.txt, sitemap), a CSS playground (HTML, CSS, JS/TS with presets and export) and CSS builders, CSP and cURL, URLs, robots.txt and sitemaps, JWT and passwords, IDs and hashes, dates and time zones, cron and RRULE
Text: regex lab, diff, text kit (transforms, line wrap, smart quotes, placeholder text), Unicode and encoding inspector
CV builder: a step-by-step wizard (no AI needed) and one bilingual (PL/EN) CV profile, saved job offers fetched from job boards, a tailored CV version per offer with an ATS check, an application tracker, and a showcase builder that drafts project entries from GitHub repos. Prints to PDF or exports DOCX.
Database course (Learn, optional sidecar): learn SQL and PostGIS by doing. 46 short lessons, from SELECT to
window functions, EXPLAIN and catchment analysis, each checked against a real PostgreSQL + PostGIS database the app
runs for you, with progressive hints and interview drills. See docs/LEARN.md.
Euro-Office (optional sidecar): create and edit DOCX, XLSX and PPTX files in a self-hosted editor that the app installs, starts and idles down by itself through Docker Compose. A small editor plugin lets the assistant edit the document you have open, live.
Craft apps (optional sidecar): PhotoCraft, VectorCraft, FilmCraft, LightCraft, EffectCraft, DesignCraft, PdfCraft, FigCraft, WordCraft, SoundCraft, DeckCraft, CADCraft and GridCraft, thirteen open-source (MIT OR Apache-2.0) creative and office apps by the ArtCraft team that run entirely in the browser as WebAssembly. A small read-only nginx container serves their official, unmodified, hash-checked release builds on an origin of their own; each app is a tab of one suite, with its licences and notices one click away. Smart Knife is not affiliated with or endorsed by the ArtCraft team; "ArtCraft" and its logos are their trademarks. See docs/SIDECARS.md "ArtCraft" and docs/LEGAL.md.
Related MCP server: CloudCrane MCP
The AI layer
Built-in assistant. A chat widget that stays mounted across navigation. The agent loop runs in the browser: UI tools (
open_tool,page_snapshot,fill_field,click,read_text,wait_for,upload_file…) act on the live DOM, and deterministicknife_*tools run on the server. Bring any OpenAI-compatible endpoint; the key stays on the server.Guardrails, not vibes. Trust modes (All / Most / Risky / None) gate acting calls, destructive actions on your input are confirmed one by one, and the agent never fabricates your files: it opens the tool and waits for you. Tool outputs chain between tools by reference (
f1,f2…), never as base64 pasted through the model.MCP endpoint.
POST /api/mcp(stateless Streamable HTTP) exposes 65 deterministic tools: CV builder, SQL/NoSQL, office documents, a course tutor and text utilities. Two MCP-only tools let an outside agent see which pages you have open and bring your visible tab to its result, with a short note on screen. Open pages refresh by themselves when an agent changes data, with Undo. See docs/MCP.md.
Engineering highlights
Registry-driven.
src/lib/registry.tsis the single source of truth for every tool: the launcher, search, command palette, routing, metadata and static params all derive from it. Slugs are permanent; retired ones 308-redirect to their new suite tab.Browser first, then a lane. Heavy browser work moves to a typed Web Worker pool (queue, cancel, timeout, crash recovery). Work that needs a real library (PDF, OCR, sqlglot) goes to one-shot Python scripts behind a bounded work queue: concurrency per lane, backpressure as
503 + Retry-After, and client aborts kill the process group.Security model. Two modes (
KNIFE_AUTH_MODE):private(default) binds to loopback or a Tailscale address only (it refuses a wildcard bind);publicruns behind a reverse proxy with registration, verified email, server-side sessions and admin/user roles (docs/ACCOUNTS.md). Every route checks Host, and every mutating route also checks Origin and accepts JSON bodies only, so cross-site "simple" requests never get through. The job-offer fetcher blocks private, loopback, link-local and CGNAT targets, including after redirects. Provider keys never reach the browser.Tested like a product. 38 unit test files and 51 Playwright end-to-end suites: every tool and tab on desktop and at 390 px, hydration across locales and time zones, the assistant against a scripted mock provider, real Docker sidecars, and an MCP-only suite that drives the UI bridge without touching the page.
flowchart LR
subgraph Browser
UI[Tool pages] --- W[Assistant widget]
UI --- WK[Web Workers]
end
subgraph Server[Next.js server]
API[API routes] --> Q[Work queue] --> PY[Python lane]
API --> ST[(Per-account data dir)]
MCP[/api/mcp/] --> API
API --> SC[Docker sidecars]
end
W -- provider proxy, knife_* tools --> API
EXT[Outside agents] -- MCP --> MCPQuick start
Requirements: Node.js 24, Python 3.12 (only for PDF/SQL server tools), and Docker (only for the office, course-database and Craft apps sidecars).
git clone https://github.com/GenorTG/samurai-knife.git && cd samurai-knife
npm install
cp .env.example .env.local # bind address, port, extra host names
npm run dev # http://127.0.0.1:3210Python lane (the venv lives outside the repo, because Turbopack chokes on a symlinked interpreter inside the project):
python3.12 -m venv ../samurai-knife-py/venv
../samurai-knife-py/venv/bin/pip install -r server/py/requirements.txt
../samurai-knife-py/venv/bin/python server/py/setup_ocr.py # Tesseract language data for searchable PDFsConfiguration
All settings live in .env.local (gitignored); see .env.example.
Variable | Default | Purpose |
|
| Bind address. Use your Tailscale IP to reach it from your other devices; |
| (empty) | Other names you open it by (machine name, LAN IP), for the Host/Origin guard and dev origins. |
|
| Accounts, CV data and documents. Never inside the repo. |
|
|
|
| (empty) | Public mode: absolute base for mail links (its host is allowed by the guard); proxy addresses whose |
|
| Account mail: SMTP, or |
|
| Interpreter for the Python lane. |
|
| Work-queue concurrency per lane. |
Accounts
In private mode (the default) there is no sign-up route: accounts are created from the CLI only, and each keeps its own model provider. Public mode adds self-registration with a verified email (contract: docs/ACCOUNTS.md).
npm run accounts -- list
npm run accounts -- add alice --name "Alice" --password-prompt
npm run accounts -- set-provider alice --base-url https://openrouter.ai/api/v1 --model openai/gpt-4o-mini --key-env OPENROUTER_API_KEYIn private mode the default account has no password: the network bind is the access boundary, so keep it on loopback or a private tailnet. Public mode never falls back to it.
npm run accounts -- set-email alice alice@example.com # owner-vouched (verified)
npm run accounts -- set-role alice admin # admin | user
npm run accounts -- set-status alice disabled # active | disabledDevelopment
npx tsc --noEmit && npm run lint # typecheck + lint
node tests/mock_provider.mjs 3299 # scripted model for assistant tests (key: mock-key)
python3 tests/run_all.py --only tsc,lint,unit,smoke,hydrationThe suites start their own throwaway server (separate worktree, temp data dir, free port), so they never touch a running instance. Details in docs/TESTING.md.
Adding a tool: add an entry to TOOLS in src/lib/registry.ts, write the component in src/tools/, and register
it in src/tools/registry-client.tsx. Nothing else is wired by hand.
Docs
docs/ARCHITECTURE.md: layout, rules and hard-won gotchas
docs/MCP.md: using the app from outside agents
docs/CV-STUDIO.md: the CV builder contract
docs/SIDECARS.md: Docker sidecars, the live office plugin and the Craft apps
docs/LEARN.md: the Database course (lessons, seed, learner sandbox)
docs/SUITES.md: how 100 small tools became 30 suites
docs/TESTING.md: every suite and how to run it
Stack
Next.js 16 (App Router, Turbopack) · React 19 · TypeScript · Tailwind CSS 4 · Zod · MCP TypeScript SDK · sql.js · pdf.js / pdf-lib · tesseract.js · Python 3.12 (pypdf, OCRmyPDF, sqlglot, python-docx) · Playwright · Docker Compose
License
PolyForm Noncommercial 1.0.0: free for personal use, study, research, hobby projects and noncommercial organizations. Commercial use, including use inside a company, needs a separate license: open an issue or contact the author.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
One drive your team and its agents share: read, write, undo from history, fork and publish.
Hosted NeuroDock — stateless communication and planning tools over OAuth-secured Streamable HTTP.
Publish HTML, docs, slides and dashboards from your AI CLI; edit them live with people.
Make and reshape shared web apps (abstracts) with your own agent.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceExposes a catalog of fast, single-purpose interactive widgets as MCP tools with sandboxed iframe apps, letting AI agents invoke them over Streamable HTTP alongside a login-free human playground. Includes tool discovery, embeddable widget views, and auto-generated discovery metadata.497 npm1MIT
- AlicenseNot gradedqualityBmaintenanceConnects an AI agent over Streamable HTTP to a workspace so it can read datasets, contracts, runs and receipts, and, when the owner permits, create fields and value sets, start runs and publish releases — while each deployed tool is also served as its own endpoint whose schema is generated from the owner's contracts. Every value comes with a receipt and safety exclusions are enforced in the query, with sensitive actions like approving review items or publishing past the accuracy gate reserved for a person.MIT

Cohort MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceLets an external AI agent work inside shared project rooms as a genuine client, handling seven tools that list and fetch projects, read full room state (project, document, recent chat, presence), post chat messages, edit the shared document, create projects, and upvote. Every action happens under a visible agent handle over the same REST and WebSocket endpoints humans use, returning schema-declared structured content and machine-readable error codes so agents can plan multi-step work.9 npmMIT- AlicenseNot gradedqualityAmaintenanceEnables AI agents to create, read, update, list, restore, and renew client-side-encrypted shared workspaces that are reachable by a single link, so several agents and people can collaborate on the same living document with version-checked writes that refuse to clobber each other.19 npmMIT



