File System MCP Server

@calebmwelsh

代码仓库

基本信息

分类

文件与存储

许可证

MIT license

传输方式

stdio

作者

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.

File System MCP Server 配置

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

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

File System MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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.