# amitte/file-system-tools

> Sandboxed local FS access — list_dir, read_file, file_metadata. Every call is checked against a per-tenant path allowlist; symlinks are resolved server-side to prevent escapes.

## Identity

- **Type:** mcp-server
- **Version:** 0.1.0
- **Trust tier:** official
- **License:** Apache-2.0
- **Authors:** Amitte Maintainers
- **Repo / bundle:** amitte/showcase
- **Canonical URL:** https://amitte.com/s/amitte/file-system-tools

## Tags

- **Capabilities:** dir-list, file-read, file-stat
- **Domains:** devtools, local-filesystem

## Evaluation

- **Adversarial score:** 85/100
- **Content score:** 72/100

## Endpoints

- **service-backed** `file-system-tools` → https://mcp.amitte.com/v1/file-system-tools/sse — Remote MCP server with a strict path allowlist over a registry-mounted directory. Compatible with Claude Desktop, Cursor, VS Code.
  - tool: `list_dir` — Read-only. List entries in a directory. Path must resolve under the allowlist; symlinks pointing outside are rejected.
  - tool: `read_file` — Read-only. Read a file's contents (utf-8) up to 1MB. Files larger than the cap return a `truncated: true` flag.
  - tool: `file_metadata` — Read-only. Stat a path — type, size, mtime, mode (octal).

## Programmatic access

- Fetch JSON-RPC: `POST https://registry.amitte.com/rpc` with `{ "method": "fetch", "params": { "id": "amitte/file-system-tools" } }`
- Install via CLI: `amitte install amitte/file-system-tools`
- HTML page: https://amitte.com/s/amitte/file-system-tools

Last updated: 2026-06-27T00:12:14.676Z