Skip to main content
Glama
MCP File Manager

MCP File Manager

MCP File Manager

A local file management MCP server built with Python and the official mcp library (FastMCP).

Features

  • List Files: List contents of directories.

  • Read Files: Read content of text files.

  • File Info: Get metadata (size, modification time) of files.

  • Search: Recursively search for files by name.

Related MCP server: MCP Filesystem Server

Dependencies

  • Python 3.10+

  • uv (recommended) or pip

Quick Start

  1. Install dependencies:

    uv sync
  2. Run the server:

    uv run main.py

Claude Desktop Configuration

Add the following to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "file-manager": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/MCP-file-managment",
        "run",
        "main.py"
      ]
    }
  }
}

Note: Replace /ABSOLUTE/PATH/TO/MCP-file-managment with the actual absolute path to the directory where you cloned this repository.

Available Tools

  • list_files(directory): List files and directories in the specified path (defaults to current directory).

  • read_file(file_path): Read the content of a text file.

  • file_info(file_path): Get file size, type, and modification time.

  • search_files(keyword): Recursively search for filenames containing a keyword in the current working directory.

Available Tools

4 tools
file_infoA
Get metadata about a file.

Args:
    file_path: Relative path to the file.

Inputs: file_path (required). Returns: result

list_filesA
List files and directories in the specified path within the workspace.

Args:
    directory: Relative path to the directory (default is root of workspace).

Inputs: directory. Returns: result

read_fileB
Read the contents of a text file.

Args:
    file_path: Relative path to the file.

Inputs: file_path (required). Returns: result

search_filesA
Recursively search for files whose names contain the keyword.
Searches from the current working directory.

Args:
    keyword: String to search for in filenames.

Inputs: keyword (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct file operation: listing directory contents, reading file content, fetching metadata, and searching filenames. There is no overlap, so an agent can easily choose the right tool.

    Naming Consistency4/5

    Three tools use the verb_noun pattern (list_files, read_file, search_files), but file_info is a noun phrase rather than a verb action. The naming is mostly consistent but has a minor deviation.

    Tool Count5/5

    Four tools is a well-scoped number for a focused file management server. Each tool serves a clear purpose without unnecessary bloat.

    Completeness2/5

    The server only provides read-only operations (list, read, info, search). There are no tools for creating, editing, or deleting files, which are essential for a true file manager, leaving significant gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables file system operations such as listing, reading, and creating files within a scoped local project directory. It provides a secure way to manage local files through standardized MCP tools built with FastMCP.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables file system operations such as listing directories, reading, writing, creating, and deleting files or directories through MCP.
      21 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables safe, read-only browsing of allowlisted local directories through MCP, providing tools to list roots, read files, and search text.
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Enables saving and managing files in a sandboxed local folder via MCP, with tools for listing, reading, writing, appending, searching, moving, and deleting files and directories.
      10
      -