Filesystem MCP Server
JSON →Provides AI agents with secure access to local filesystem operations like reading, writing, and managing files and directories.
Tools · 10
- set_filesystem_default Sets a default absolute path for the current session. Relative paths used in subsequent tool calls will be resolved against this default. Resets on server restart.
- read_file Reads the entire content of a specified file as UTF-8 text. Accepts relative (resolved against default) or absolute paths.
- write_file Writes content to a specified file. Creates the file (and necessary parent directories) if it doesn't exist, or overwrites it if it does. Accepts relative or absolute paths.
- update_file Performs targeted search-and-replace operations within an existing file using an array of {search, replace} blocks. Ideal for localized changes. Supports plain text or regex search (useRegex: true) and replacing all occurrences (replaceAll: true). Accepts relative or absolute paths. File must exist.
- list_files Lists files and directories within a specified path. Options include recursive listing (includeNested: true) and limiting the number of entries (maxEntries). Returns a formatted tree structure. Accepts relative or absolute paths.
- delete_file Permanently removes a specific file. Accepts relative or absolute paths.
- delete_directory Permanently removes a directory. Use recursive: true to remove non-empty directories and their contents (use with caution!). Accepts relative or absolute paths.
- create_directory Creates a new directory at the specified path. By default (create_parents: true), it also creates any necessary parent directories. Accepts relative or absolute paths.
- move_path Moves or renames a file or directory from a source path to a destination path. Accepts relative or absolute paths for both.
- copy_path Copies a file or directory from a source path to a destination path. For directories, it copies recursively by default (recursive: true). Accepts relative or absolute paths.
Environment variables
MCP_HTTP_PORTMCP_HTTP_HOSTMCP_AUTH_SECRET_KEYOPENROUTER_APP_URLOPENROUTER_API_KEYGEMINI_API_KEYOAUTH_PROXY_AUTHORIZATION_URLOAUTH_PROXY_TOKEN_URLOAUTH_PROXY_REVOCATION_URLOAUTH_PROXY_ISSUER_URLOAUTH_PROXY_SERVICE_DOCUMENTATION_URL
Links
★ 37 GitHub stars