Filesystem MCP Server SSE

MIT License
29,124
  • Linux
  • Apple

Integrations

  • Enables filesystem operations on Linux systems, including reading/writing files, managing directories, and searching files with specific run instructions for Linux environments.

  • Supports filesystem operations on macOS, with specific run instructions for accessing and manipulating files and directories on Apple's operating system.

  • Provides a Node.js server implementation of the MCP protocol for filesystem operations, enabling reading, writing, and managing files and directories.

Filesystem MCP Server SSE

Node.js server SSE implementing Model Context Protocol (MCP) for filesystem operations.

Features

  • Read/write files
  • Create/list/delete directories
  • Move files/directories
  • Search files
  • Get file metadata

Note: The server will only allow operations within directories specified via args.

API

Resources

  • file://system: File system operations interface

Tools

  • 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 (exercise caution with this)
    • Inputs:
      • path (string): File location
      • content (string): File content
  • edit_file
    • Make selective edits using advanced pattern matching and formatting
    • Features:
      • Line-based and multi-line content matching
      • Whitespace normalization with indentation preservation
      • Multiple simultaneous edits with correct positioning
      • Indentation style detection and preservation
      • Git-style diff output with context
      • Preview changes with dry run mode
    • Inputs:
      • path (string): File to edit
      • edits (array): List of edit operations
        • oldText (string): Text to search for (can be substring)
        • newText (string): Text to replace with
      • dryRun (boolean): Preview changes without applying (default: false)
    • Returns detailed diff and match information for dry runs, otherwise applies changes
    • Best Practice: Always use dryRun first to preview changes before applying them
  • 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
    • Input: path (string)
  • move_file
    • Move or rename files and directories
    • Inputs:
      • source (string)
      • destination (string)
    • Fails if destination exists
  • search_files
    • Recursively search for files/directories
    • Inputs:
      • path (string): Starting directory
      • pattern (string): Search pattern
      • excludePatterns (string[]): Exclude any patterns. Glob formats are supported.
    • Case-insensitive matching
    • Returns full paths to matches
  • 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

Run & Usage

Local

1. build:
npm install
2.1 run Windows:
node .\dist\index.js C:\Users\User

allowed directories: C:\Users\User

2.2 run Macos / Linux:
node ./dist/index.js /Users

allowed directories: /Users

3. config:
{ "mcpServers": { "file_system": { "name": "file_system", "baseUrl": "http://127.0.0.1:3001/sse" } } }

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

-
security - not tested
A
license - permissive license
-
quality - not tested

Node.js server implementing Model Context Protocol (MCP) for filesystem operations, allowing AI systems to read, write, edit files and manage directories within specified allowed paths.

  1. Features
    1. API
      1. Resources
      2. Tools
    2. Run & Usage
      1. Local
    3. License

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        Node.js server implementing Model Context Protocol (MCP) for filesystem operations.
        Last updated -
        29,124
        43,205
        JavaScript
        MIT License
        • Linux
        • Apple
      • -
        security
        F
        license
        -
        quality
        Node.js server implementing Model Context Protocol for filesystem operations, allowing Claude to read, write, and manipulate files and directories in specified locations.
        Last updated -
        29,124
        JavaScript
      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.
        Last updated -
        47
        1
        JavaScript
        MIT License
        • Linux
      • -
        security
        F
        license
        -
        quality
        A Node.js server that implements Model Context Protocol (MCP) for controlling HWP (Korean word processor) documents, allowing AI assistants like Claude to create and manipulate Hangul documents.
        Last updated -
        27
        Python

      View all related MCP servers

      ID: 77fwrjn89r