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.