cyanheads/filesystem-mcp-server

View on GitHub ↗

A Model Context Protocol (MCP) server for platform-agnostic file capabilities, including advanced search/replace and directory tree traversal

48 ★27 forksTypeScriptUpdated 1y ago

What you need to know

Production-oriented TypeScript MCP server for secure, platform-agnostic filesystem access with both STDIO and Streamable HTTP transports. Tools: set_filesystem_default, read_file, write_file, update_file (search-and-replace with plain text or regex), list_files, delete_file, delete_directory, create_directory, move_path, and copy_path. Security-first: path sanitization against traversal, FS_BASE_DIRECTORY sandboxing, JWT auth and rate limiting for HTTP, Zod input validation, and context-aware Winston logging. Apache-2.0; beta status.

Install

git clone https://github.com/cyanheads/filesystem-mcp-server.git && npm install && npm run build

Key features

  • ✓10 filesystem tools including search-and-replace update_file
  • ✓STDIO and Streamable HTTP transports (Express, JWT auth)
  • ✓FS_BASE_DIRECTORY sandboxing and path traversal protection
  • ✓Zod-validated config and inputs
  • ✓Context-aware logging and standardized errors
Clients: Any MCP client

Reviewed 2026-08-11

Topics

aicyanheadsfilesystemllm-agentsmcpmcp-servermodel-context-protocol
Stars
48★
Forks
27
Language
TypeScript
License
Apache-2.0
Created
2025-04-13
Last push
2025-07-22