File System MCP Server

Name: File System MCP Server
Author: calebmwelsh

@calebmwelsh

关于 File System MCP Server

A comprehensive MCP (Model Context Protocol) server for file system operations, providing Claude and other AI assistants with access to local files and directories.

基本信息

分类

文件与存储

许可证

MIT license

运行时

python

传输方式

stdio

发布者

calebmwelsh

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "file-system-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is File System MCP Server?

A file system management server built with FastMCP that provides a comprehensive set of tools for file and directory operations. It allows performing various file system operations through a structured API, making it ideal for automation and integration with other systems.

How to use File System MCP Server?

Clone the repository, create and activate a virtual environment, install dependencies with pip install -r requirements.txt, then configure the server in your MCP client (e.g., Claude) by adding the server's command and path to claude_desktop_config.json. After configuration, restart the client and use the provided tools by asking the AI to perform file operations.

Key features of File System MCP Server

Copy, move, delete files with backup and safety checks
Read, write, and search files by name pattern
List, create, delete directories, including recursive tree views
Get file information, directory statistics, disk usage, and system info
Create file collections with optional custom storage path
Windows full support; macOS/Linux support for basic operations

Use cases of File System MCP Server

Automate file organization and backup tasks via an MCP client
Integrate file system operations into AI-driven workflows
Manage remote file systems through a structured API
Perform bulk file operations with safety checks and error handling

FAQ from File System MCP Server

What operating systems does File System MCP Server support?

Windows has full feature support including drive listing and special folders. macOS and Linux support basic file/directory operations, file search, and metadata, but some Windows-specific features are unavailable.

What dependencies are required?

Required dependencies: FastMCP, Pydantic. On Windows, pywin32 and WMI are also needed. Install all with pip install -r requirements.txt.

How do I find the Python path for configuration?

On Windows PowerShell: (Get-Command python).Source. On Windows CMD: where python. On Linux/macOS: which python. Use the returned path in your MCP configuration.

Are there any known issues?

Yes. The delete_file function may fail to properly delete files. The list_drives function may not correctly detect all drives. Both issues are under investigation.

How are file collections stored?

Collections can be stored in any user-specified directory. If no storage path is given, they are stored in a default location inside the project's data/collections directory.