Skip to main content
Glama

Filesystem MCP Server

by ai-yliu

Filesystem MCP Server

A Model Context Protocol (MCP) server that provides filesystem operations for Claude AI.

Features

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

Security

The server only allows operations within directories specified via command-line arguments.

Installation

  1. Clone this repository
  2. Install dependencies: npm install
  3. Build the project: npm run build

Usage

Run the server with one or more allowed directories:

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

MCP Configuration

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": [] } } }

License

ISC

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

local-only server

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

An MCP server that allows Claude AI to perform filesystem operations including reading, writing, listing, moving files, and searching directories within specified allowed paths.

  1. Features
    1. Security
      1. Installation
        1. Usage
          1. MCP Configuration
            1. License

              Related MCP Servers

              • -
                security
                A
                license
                -
                quality
                An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
                Last updated -
                229
                Python
                MIT License
                • Apple
                • Linux
              • -
                security
                F
                license
                -
                quality
                An MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.
                Last updated -
                46
                Python
                • Apple
              • -
                security
                A
                license
                -
                quality
                A comprehensive MCP (Model Context Protocol) server for file system operations, providing Claude and other AI assistants with access to local files and directories.
                Last updated -
                1
                Python
                MIT License
                • Apple
                • Linux
              • A
                security
                A
                license
                A
                quality
                An MCP server that allows Claude AI to search, explore, and compare arXiv papers efficiently through a custom-built local server.
                Last updated -
                4
                4
                Python
                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/ai-yliu/filesystem-mcp-server'

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