Filesystem
About
Filesystem MCP server for secure file operations inside configured directories, including reading, writing, listing, and project navigation.
Details
- Author
- ai-yliu
- Repository
- ai-yliu/filesystem-mcp-server
- GitHub stars
- 1
- Categories
- File Management, Developer Tools, Other, AI, Design, Infrastructure, Automation, API, Security
Jump to
This MCP server provides the following filesystem operations:
1. read_file: Read complete contents of a file
- Input: path (string)
- Reads complete file contents with UTF-8 encoding
2. read_multiple_files: Read multiple files simultaneously
- Input: paths (string[])
- Failed reads won't stop the entire operation
3. write_file: Create new file or overwrite existing
- Inputs:
- path (string): File location
- content (string): File content
4. create_directory: Create new directory or ensure it exists
- Input: path (string)
- Creates parent directories if needed
- Succeeds silently if directory exists
5. list_directory: List directory contents with [FILE] or [DIR] prefixes
- Input: path (string)
6. move_file: Move or rename files and directories
- Inputs:
- source (string)
- destination (string)
- Fails if destination exists
7. search_files: Recursively search for files/directories
- Inputs:
- path (string): Starting directory
- pattern (string): Search pattern
- Case-insensitive matching
- Returns full paths to matches
8. get_file_info: Get detailed file/directory metadata
- Input: path (string)
- Returns:
- Size
- Creation time
- Modified time
- Access time
- Type (file/directory)
- Permissions
9. list_allowed_directories: List all directories the server is allowed to access
- No input required
- Returns directories that this server can read/write from
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
FilesystemCommand (node, npx, python, etc.)nodeArguments-
Argument 1
/path/to/filesystem-server/build/index.js -
Argument 2
/path/to/allowed/dir1 -
Argument 3
/path/to/allowed/dir2
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the server with one or more allowed directories:
node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2
Add the server to your MCP configuration file:
{
"mcpServers": {
"filesystem-server": {
"command": "node",
"args": [
"/path/to/filesystem-server/build/index.js",
"/path/to/allowed/dir1",
"/path/to/allowed/dir2"
],
"disabled": false,
"autoApprove": []
}
}
}
read_file
Read complete contents of a file. Input: path (string)
read_multiple_files
Read multiple files simultaneously. Input: paths (string[])
write_file
Create new file or overwrite existing. Inputs: path (string), content (string)
create_directory
Create new directory or ensure it exists. Input: path (string)
list_directory
List directory contents with [FILE] or [DIR] prefixes. Input: path (string)
move_file
Move or rename files and directories. Inputs: source (string), destination (string)
search_files
Recursively search for files/directories. Inputs: path (string), pattern (string)
get_file_info
Get detailed file/directory metadata. Input: path (string)
list_allowed_directories
List all directories the server is allowed to access. No input required
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"filesystem": {
"cwd": "string",
"env": {},
"args": [
"/path/to/filesystem-server/build/index.js",
"/path/to/allowed/dir1",
"/path/to/allowed/dir2"
],
"shell": false,
"command": "node"
}
}
}Linux
{
"cwd": "string",
"env": [],
"args": [
"/path/to/filesystem-server/build/index.js",
"/path/to/allowed/dir1",
"/path/to/allowed/dir2"
],
"shell": false,
"command": "node"
}Macos
{
"cwd": "string",
"env": [],
"args": [
"/path/to/filesystem-server/build/index.js",
"/path/to/allowed/dir1",
"/path/to/allowed/dir2"
],
"shell": false,
"command": "node"
}Windows
{
"cwd": "string",
"env": [],
"args": [
"/c",
"node",
"/path/to/filesystem-server/build/index.js",
"/path/to/allowed/dir1",
"/path/to/allowed/dir2"
],
"shell": false,
"command": "cmd"
}Filesystem MCP server for secure file operations inside configured directories, including reading, writing, listing, and project navigation.
A Model Context Protocol (MCP) server that provides filesystem operations for Claude AI.
This MCP server provides the following filesystem operations:
-
read_file: Read complete contents of a file
- Input:path(string)
- Reads complete file contents with UTF-8 encoding
read_multiple_files: Read multiple files simultaneously
- Input:paths(string[])
- Failed reads won't stop the entire operation
write_file: Create new file or overwrite existing
- Inputs:
- path(string): File location
- content(string): File content
create_directory: Create new directory or ensure it exists
- Input:path(string)
- Creates parent directories if needed
- Succeeds silently if directory exists
list_directory: List directory contents with [FILE] or [DIR] prefixes
move_file: Move or rename files and directories
- Inputs:
- source(string)
- destination(string)
search_files: Recursively search for files/directories
- Inputs:
- path(string): Starting directory
- pattern(string): Search pattern
get_file_info: Get detailed file/directory metadata
- Input:path(string)
- Returns:
- Size
- Creation time
- Modified time
- Access time
- Type (file/directory)
- Permissions
list_allowed_directories: List all directories the server is allowed to access
- No input required
- Returns directories that this server can read/write from
The server only allows operations within directories specified via command-line arguments.
- Clone this repository
- Install dependencies:npm install
- Build the project:npm run build
Run the server with one or more allowed directories:
node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2
Add the server to your MCP configuration file:
{ "mcpServers": { "filesystem-server": { "command": "node", "args": [ "/path/to/filesystem-server/build/index.js", "/path/to/allowed/dir1", "/path/to/allowed/dir2" ], "disabled": false, "autoApprove": [] } } }
An MCP server for viewing, editing, and creating text files, based on the Claude built-in text editor tool.
Provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
Provides AI agents with secure access to local filesystem operations like reading, writing, and managing files and directories.
Perform file system operations such as reading, writing, patching, and managing directories.
Provides read-only access to local files and directories.
Local-first PDF engine for AI agents. Zero-dep TypeScript, PDF/A, signatures, 800+ pages/sec.
A pyRevit-based MCP server for Autodesk Revit, enabling connection to any MCP-compatible client.
A local server that allows AI to execute Windows CMD commands, read/write files, and manage directories within a specified path.
Securely browse and read files within an Android project, with built-in validation and access controls for sensitive directories.
A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
