MCP Filesystem Server

@Spark-Liang

关于 MCP Filesystem Server

暂无概览

配置

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

{
  "mcpServers": {
    "mcp-filesystem-server-spark-liang": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

工具

未检测到工具

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

概览

What is MCP Filesystem Server?

MCP Filesystem Server is a filesystem server built on the Model Context Protocol (MCP) using Python and FastMCP. It provides secure, controlled access to the local filesystem through a set of tools and resources, making file operations available to MCP-compatible clients like Claude Desktop.

How to use MCP Filesystem Server?

Install with uv sync or pip install -e .. Run with the command mcp-filesystem-server (default stdio mode). Use --allowed-dir (or -d) to specify which directories the server can access. For HTTP or SSE modes, add http or sse and optionally set --port and --host.

Key features of MCP Filesystem Server

Secure access control: only allowed directories are accessible
Complete file operations: read, write, create, move, search
12 MCP tools for file and image handling
File and directory resources via MCP resource protocol
Supports stdio, HTTP, and SSE transport modes
Full test coverage and path traversal prevention

Use cases of MCP Filesystem Server

Integrate with Claude Desktop to read and write files in a workspace
Build a secure file server for MCP‑aware applications
Expose directory listings and file contents to remote clients via HTTP/SSE
Automate file editing and searching inside restricted folders
Provide a controlled file system interface for AI assistants

FAQ from MCP Filesystem Server

What does MCP Filesystem Server do?

It exposes local filesystem operations (read, write, create, move, search) through the MCP protocol, with strict access control to only allowed directories.

What are the runtime requirements?

Python 3.10 or higher. Installation is recommended via uv, but pip works as well.

How do I restrict which directories the server can access?

Use the --allowed-dir (or -d) option when starting the server. You can specify multiple directories. The server will refuse any operation outside these paths.

Can I run MCP Filesystem Server over HTTP or SSE?

Yes. Run mcp-filesystem-server http --port 8080 --allowed-dir /path for HTTP, or mcp-filesystem-server sse --host 0.0.0.0 --port 3000 for Server‑Sent Events.

Is MCP Filesystem Server secure?

Yes. It performs path validation to prevent directory traversal attacks, checks permissions on every operation, and provides safe error messages that do not leak system information.

常见问题