MCP File System Server

@asirulnik

代码仓库

基本信息

分类

文件与存储

许可证

MIT license

传输方式

stdio

作者

asirulnik

关于 MCP File System Server

暂无概览

#mcp #file-system #server #ai-assistant

MCP File System Server 配置

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

{
  "mcpServers": {
    "mcp_server_filesystem_01": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

MCP File System Server 工具

Lists files and directories in the project directory

Reads the contents of a file

Creates or overwrites files atomically

Adds content to existing files

Removes files from the filesystem

Makes selective edits using pattern matching

概览

What is MCP File System Server?

MCP File System Server is a Model Context Protocol server that enables AI assistants (via Claude Desktop, VSCode/Cline extension, or other MCP-compatible systems) to perform file system operations—read, write, edit, delete—within a specified project directory. It is built for developers who want to collaborate with AI on local codebases through natural-language prompts.

How to use MCP File System Server?

Install the server by cloning the repository and running pip install -e . inside its directory. Then launch it with python -m src.main --project-dir /path/to/project, optionally setting --log-level and --log-file. Add the server’s configuration to your MCP client’s settings (e.g., Claude Desktop’s claude_desktop_config.json or Cline’s cline_mcp_settings.json) and restart the client.

Key features of MCP File System Server

list_directory: list files and directories in the project directory
read_file: read the contents of a file
save_file: atomically create or overwrite files with content
append_file: append content to an existing file
delete_this_file: permanently delete a file from the filesystem
edit_file: make selective edits using pattern matching with diff preview

Use cases of MCP File System Server

AI-assisted code review and analysis of existing project files
Generating and writing new files (e.g., scaffolding, configuration) based on natural-language descriptions
Making targeted edits to source code without rewriting entire files
Debugging and fixing issues by reading, analyzing, and updating code
Building complete implementations from specifications through iterative prompting

常见问题

What operations does the server support?

It supports six tools: `list_directory`, `read_file`, `save_file`, `append_file`, `delete_this_file`, and `edit_file` (which offers line-based pattern matching and dry-run previews).

What are the runtime requirements?

Python 3 (with a virtual environment recommended) and the dependencies installed via `pip install -e .`. The server uses FastMCP and can be run on Windows, macOS, or Linux.

Where are logs stored, and how are they formatted?

Standard human-readable logs go to the console. Optionally, structured JSON logs can be written to a file specified with `--log-file`. Log level is configurable (DEBUG, INFO, WARNING, ERROR, CRITICAL).

How does the server ensure security?

All file paths are normalized and validated to stay within the project directory; path traversal attacks are blocked. Files are written atomically to prevent data corruption, and the `--project-dir` argument is required.

What transports and authentication are supported?

The server communicates via MCP’s standard transport (stdin/stdout) used by Claude Desktop and Cline. No external API endpoints or authentication are mentioned—access is governed by the MCP client’s auto-approval settings.

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

Google Drive server

isaacphi

Model Context Protocol (MCP) Server for reading from Google Drive and editing Google Sheets

283

Filesystem MCP Server SSE

ysthink

The SSE version of the MCP service is modified from the Filesystem MCP server

PDF Extraction MCP Server (Claude Code Fork)

xraywu

MCP server to extract contents from a PDF file

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

drop.media

Upload once. Find, use and share across your AI workflows. drop.media is one media library for you and every AI agent you use: files added from Claude, ChatGPT, Cursor, the terminal or the web can be found, reused and sh