Python (MCP) Filesystem Server

@hypercat

代码仓库

基本信息

分类

文件与存储

传输方式

stdio

作者

hypercat

关于 Python (MCP) Filesystem Server

This is a robust Python-based MCP Filesystem Server. It enables AI models and applications to securely interact with the host system's file directories through a defined set of tools, allowing for operations like reading, writing, moving, and listing files and directories.

#filesystem #python #mcp

Python (MCP) Filesystem Server 配置

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

{
  "mcpServers": {
    "PyMCP-FS": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-r",
        "pyproject.toml"
      ]
    }
  }
}

Python (MCP) Filesystem Server 工具

工具列表暂未提供

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

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

概览

What is Python (MCP) Filesystem Server?

Python (MCP) Filesystem Server is a Python-based Model Context Protocol (MCP) server that enables AI models and applications to securely interact with host file directories via a defined set of tools. It uses the fastmcp library and confines all file operations to a configurable list of allowed directories.

How to use Python (MCP) Filesystem Server?

Clone the repository and initialize with uv pip install -r pyproject.toml. Run python3 main.py -d /path/to/allowed/dir1 /path/to/another/allowed/dir2 [--log-level LEVEL] [--log-file PATH]. The server listens for MCP messages on stdin and responds on stdout. A test script (test_mcp_server.py) is provided to verify functionality.

Key features of Python (MCP) Filesystem Server

Strict confinement to predefined allowed directories.
Tools for reading, writing, editing, moving, and listing files.
Recursive directory tree generation.
Configurable logging with file rotation.
Symlink validation to prevent path escape.

Use cases of Python (MCP) Filesystem Server

Allowing an AI assistant to read and edit source code in a project directory.
Enabling a chatbot to manage user-uploaded files (e.g., drafts, notes).
Providing controlled filesystem access for automated reporting or data processing tools.
Letting an AI model safely list and inspect files within a sandboxed workspace.

常见问题

What directories can the server access?

Directories are specified at startup via the `-d` or `--directories` argument. The server will only operate within those paths.

What Python version and dependencies are required?

Python 3.8 or higher is required, along with the `fastmcp` library.

How does the server handle symlinks?

Symlink targets are validated to ensure they do not point outside the configured allowed directories, preventing path escape.

What transport protocol does the server use?

The server uses standard input/output (stdin/stdout) for MCP communication, adhering to JSON‑RPC 2.0 messages.

What logging options are available?

Log level can be set via `--log-level` (DEBUG, INFO, WARNING, ERROR; default INFO). An optional `--log-file` writes logs to a rotating file.

文件与存储分类下的更多 MCP 服务器

Mcp Google Sheets

xing5

This MCP server integrates with your Google Drive and Google Sheets, to enable creating and modifying spreadsheets.

934

Storacha MCP Storage Server

storacha

Storacha MCP storage server - self-sovereign data for your AI applications.

DeviceLink

Jayanka Sampath

DeviceLink lets you share folders from your computer with AI assistants, securely and in real-time. Nothing is uploaded. Your files stay on your machine, and are only accessible while the device sharing them is connected

mcp-v8: V8 JavaScript MCP Server

r33drichards

MCP server that exposes a V8 JavaScript runtime as a tool for AI agents like Claude and Cursor. Supports persistent heap snapshots via S3 or local filesystem, and is ready for integration with modern AI development environments.

PDF Reader MCP Server (@sylphlab/pdf-reader-mcp)

sylphlab

📄 The PDF intelligence layer for AI agents — Agent Document Twin, evidence-first extraction, visual crops, OCR provenance, trust reports, and benchmark-gated releases. MCP server for Claude, Cursor, VS Code, and any MCP client.

810