Loading connector details…
Filesystem MCP Server
MCPOpen SourceMIT34.7
by ysthink • File & Storage
A Node.js SSE MCP server that exposes sandboxed filesystem operations (read, write, edit, move, search, and metadata) for programmatic agents.
Example Use Cases
- 1
Programmatic read/write access to files and directories inside sandboxed mounts for code editing or content generation.
- 2
Perform safe, previewable edits to source files using indentation-aware, multi-edit operations with dry-run diffs.
- 3
Search, list, move, or retrieve metadata for files across allowed project directories (for indexing, analysis, or synchronization).
Description
This repository implements a Model Context Protocol (MCP) server over Server-Sent Events (SSE) to allow agents to perform file system operations within configured allowed directories. It provides tools to read and write files, create and list directories, move and delete items, search files with glob/exclude patterns, and get detailed file metadata. The edit_file tool supports advanced, line-aware edits with indentation preservation, dry-run previews, and git-style diffs to safely preview changes before applying them. The server can be run locally or in Docker and is licensed under the MIT License.
Capabilities(14 total)
Tools (14)
read_file
Read the complete contents of a file as text. DEPRECATED: Use read_text_file instead.
path:string*tail:numberhead:number
read_text_file
Read the complete contents of a file from the file system as text. Handles various text encodings and provides detailed error messages if the file cannot be read. Use this tool when you need to examine the contents of a single file. Use the 'head' parameter to read only the first N lines of a file, or the 'tail' parameter to read only the last N lines of a file. Operates on the file as text regardless of extension. Only works within allowed directories.
path:string*tail:numberhead:number
read_media_file
Read an image or audio file. Returns the base64 encoded data and MIME type. Only works within allowed directories.
path:string*
read_multiple_files
Read the contents of multiple files simultaneously. This is more efficient than reading files one by one when you need to analyze or compare multiple files. Each file's content is returned with its path as a reference. Failed reads for individual files won't stop the entire operation. Only works within allowed directories.
paths:array*
write_file
Create a new file or completely overwrite an existing file with new content. Use with caution as it will overwrite existing files without warning. Handles text content with proper encoding. Only works within allowed directories.
path:string*content:string*
Quick Actions
Security
Scanned 3 month(s) agoRisk Level
MODERATE
Can modify files, state, or send data externally
Trust Score
C63/100
11/17 checks passed
Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.
Quick Stats
Service TypeMCP
Pricing ModelFree
Capabilities14 Tools / 0 Prompts / 0 Resources
Ownerysthink
CategoryFile & Storage
DependenciesStandalone
Tags
File SystemEditingDiffMetadataSandbox