nogoo9 / mcp-server-cloud-fs / 25690758441

67%

push

github

release: v0.3.0 — Shell tool, MemoryProvider, SqliteProvider, xterm.js App (#3)

* feat: add shell tool with 17 POSIX-like commands for cloud fs (v0.3.0)

- New `shell` MCP tool gated by `--enable-shell` CLI flag
- 17 built-in commands: ls, cat, head, tail, cp, mv, rm, mkdir, touch,
  stat, find, grep, wc, du, echo, tee, diff
- Pipe support (|), input redirection (<), output redirection (>, >>)
- All commands execute in-process against the VFS — no real shell spawned
- Destructive commands (rm, mv) additionally gated by `--enable-delete`
- Programmatic API: `executeShell(command, ctx)` exported from npm lib
- 48 new unit tests (parser, commands, pipelines, security)
- Bump version to 0.3.0 across package.json, server.json, server.ts

* feat: add MemoryProvider, SqliteProvider, xterm.js MCP App, MCP Inspector scripts

- MemoryProvider: fully in-process Map-based storage for demos/tests (zero deps)
- SqliteProvider: persistent local storage using bun:sqlite (zero external deps, WAL mode)
- xterm.js MCP App: interactive terminal UI via MCP Apps extension (Catppuccin theme, command history)
- MCP Inspector: bun run inspect / inspect:memory scripts for server validation
- Extended ParsedRoot scheme to support mem:// and sqlite:// URIs
- Added --sqlite-db CLI flag for SQLite database file path
- 26 new unit tests for both providers
- Updated README, CHANGELOG, lib.ts exports

* feat: infer content type from magic bytes, fallback to extension

- New shared utility: src/providers/content-type.ts
- Checks buffer magic bytes first (PNG, JPEG, GIF, PDF, ZIP, GZIP, WASM, etc.)
- RIFF disambiguation (WEBP vs WAV)
- Falls back to extension for text formats (no magic bytes, no exception)
- Expanded extension map: 50+ MIME types
- 22 dedicated tests for content-type inference
- Both MemoryProvider and SqliteProvider use the shared utility
- Exported as inferContentType from lib.ts

* refactor: use file-type library for robust magic-byte content detection

- Replace h... (continued)

764 of 1103 new or added lines in 27 files covered. (69.27%)

1946 of 2925 relevant lines covered (66.53%)

24.22 hits per line