Back to Home
iceener icon

files-stdio-mcp-server

Verified Safe

by iceener

Overview

Provides a sandboxed filesystem interface for AI agents to explore directories, read, search, and safely edit text files with checksum verification and diff previews.

Installation

Run Command
bun run /absolute/path/to/files-mcp/src/index.ts

Environment Variables

  • FS_ROOTS
  • FS_ROOT
  • LOG_LEVEL
  • MAX_FILE_SIZE
  • MCP_NAME
  • MCP_VERSION
  • MCP_INSTRUCTIONS

Security Notes

The server implements robust sandboxing through explicit path resolution, checking for absolute paths and directory traversal attempts ('..'). Access is restricted to user-configured 'FS_ROOTS' (or 'FS_ROOT') environment variables. Checksum verification prevents stale overwrites during file edits. No 'eval' or other dynamic code execution patterns were identified in the provided source. The server's security is highly dependent on the user correctly configuring the 'FS_ROOTS' variable to trusted directories.

Similar Servers

Stats

Interest Score83
Security Score9
Cost ClassMedium
Avg Tokens1000
Stars4
Forks0
Last Update2025-12-04

Tags

filesystemfile managementAI agentsandboxtext processingObsidian