Skip to main content
Glama

Readonly Filesystem MCP Server

Readonly Filesystem MCP Server

Node.js server implementing Model Context Protocol (MCP) for readonly filesystem operations. A clone from modelcontextprotocol/server-filesystem.

Features

  • Read files
  • List 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
    • Inputs:
      • path (string): File path to read
      • from (number): Optional. Start line number for reading. Defaults to 0.
      • to (number): Optional. End line number. If not set, reads to the end of the file.
    • Reads file contents (full or partial) with UTF-8 encoding
  • read_multiple_files
    • Read multiple files simultaneously
    • Input: paths (string[])
    • Failed reads won't stop the entire operation
  • list_directory
    • List directory contents with [FILE] or [DIR] prefixes
    • Input: path (string)
  • 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

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Note: you can provide sandboxed directories to the server by mounting them to /projects. Adding the ro flag will make the directory readonly by the server.

NPX

{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@danielsuguimoto/readonly-server-filesystem", "/Users/username/Desktop", "/path/to/other/allowed/dir" ] } } }

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

local-only server

The server can only run on the client's local machine because it depends on local resources.

Node.js server implementing Model Context Protocol for secure read-only filesystem operations, allowing Claude to read files, list directories, search files, and get file metadata within specified directories.

  1. Features
    1. API
      1. Resources
      2. Tools
    2. Usage with Claude Desktop
      1. NPX
    3. License

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        Node.js server implementing Model Context Protocol (MCP) for filesystem operations.
        Last updated -
        51,603
        62,433
        TypeScript
        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 -
        51,603
        JavaScript
      • A
        security
        F
        license
        A
        quality
        Node.js server implementing Model Context Protocol (MCP) for filesystem operations with comprehensive permission controls, allowing secure file and directory manipulation with granular access restrictions.
        Last updated -
        21
        51,603
        3
        TypeScript
        • Linux
        • Apple
      • -
        security
        A
        license
        -
        quality
        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.
        Last updated -
        51,603
        JavaScript
        MIT License
        • Linux
        • Apple

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/danielsuguimoto/readonly-filesystem-mcp'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server