Skip to main content
Glama
MCP File System

MCP File System

by Wayazi

MCP File System

A Model Context Protocol (MCP) server that provides filesystem operations through a standardized interface.

Features

  • File operations (read/write)

  • Directory management (create/list/delete)

  • File movement and renaming

  • File metadata retrieval

  • File search capabilities

  • Access control through allowed directories

Related MCP server: MCP Filesystem Server

Getting Started

  1. Install dependencies:

npm install
  1. Build the project:

npm run build
  1. Run the server with allowed directories:

npm start /path/to/allowed/directory [/path/to/another/directory ...]

Documentation

Development

The server is built using:

  • TypeScript

  • MCP SDK (high-level API)

  • Node.js filesystem APIs

Security

The server implements path validation to ensure operations only occur within allowed directories specified at startup.

License

ISC

Available Tools

9 tools
create_directoryD

Inputs: path (required).

get_file_infoD

Inputs: path (required).

list_allowed_directoriesD

Inputs: no named parameters.

list_directoryD

Inputs: path (required).

move_fileD

Inputs: destination (required), source (required).

read_fileD

Inputs: path (required).

read_multiple_filesD

Inputs: paths (required).

search_filesD

Inputs: path (required), pattern (required), excludePatterns.

write_fileD

Inputs: content (required), path (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. Tools like create_directory, list_directory, read_file, write_file, move_file, and search_files all target specific file system operations without overlap. Even read_file and read_multiple_files are clearly differentiated by single vs. batch operations.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case throughout. Examples include create_directory, list_directory, read_file, write_file, move_file, search_files - this predictable naming makes the toolset easy to navigate and understand.

    Tool Count5/5

    With 9 tools, this is well-scoped for a file system server. Each tool earns its place by covering essential operations: directory management, file reading/writing, file operations, and searching. The count is neither too sparse nor overwhelming for the domain.

    Completeness4/5

    The toolset provides excellent coverage of core file system operations including CRUD-like functionality (create, read, write, move) and directory operations. The only minor gap is the absence of delete operations (delete_file, delete_directory), but agents can work around this limitation for most workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.
      22
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
      21
      67
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A secure Model Context Protocol server that provides controlled filesystem access within predefined directories, enabling AI models to perform file and directory operations with strict path validation.
      16
      95 npm
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
      8
      Apache 2.0