Skip to main content
Glama
Samurai Knife MCP Server

Samurai Knife MCP Server

by GenorTG

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.

Launcher

JSON workbench

SQL lab

CV builder

CV version with live preview

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 deterministic knife_* 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.ts is 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); public runs 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 --> MCP

Quick 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:3210

Python 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 PDFs

Configuration

All settings live in .env.local (gitignored); see .env.example.

Variable

Default

Purpose

KNIFE_HOST / KNIFE_PORT

127.0.0.1 / 3210

Bind address. Use your Tailscale IP to reach it from your other devices; 0.0.0.0 is refused.

KNIFE_ALLOWED_HOSTS

(empty)

Other names you open it by (machine name, LAN IP), for the Host/Origin guard and dev origins.

KNIFE_DATA_DIR

~/.local/share/samurai-knife

Accounts, CV data and documents. Never inside the repo.

KNIFE_AUTH_MODE

private

public = multi-user (registration, verified email, roles); see docs/ACCOUNTS.md.

KNIFE_PUBLIC_URL / KNIFE_TRUSTED_PROXIES

(empty)

Public mode: absolute base for mail links (its host is allowed by the guard); proxy addresses whose X-Forwarded-* headers are trusted.

KNIFE_MAIL_TRANSPORT, KNIFE_SMTP_*

outbox (private) / smtp (public)

Account mail: SMTP, or .eml files in $KNIFE_DATA_DIR/mail-outbox/.

KNIFE_PYTHON

../samurai-knife-py/venv/bin/python

Interpreter for the Python lane.

KNIFE_PY_LIGHT / KNIFE_PY_HEAVY

4 / 1

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_KEY

In 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 | disabled

Development

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,hydration

The 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

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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes 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 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT