MCP.so
登录

MCP File System Server

@asirulnik

代码仓库

关于 MCP File System Server

暂无概览

基本信息

分类

文件与存储

许可证

MIT license

运行时

python

传输方式

stdio

发布者

asirulnik

配置

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

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

工具

6

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 simple Model Context Protocol (MCP) server that provides file system operations. It enables AI assistants like Claude to read, write, update, and delete files within a specified project directory, securely containing all operations.

How to use MCP File System Server?

Install by cloning the repository, creating a virtual environment, and running pip install -e .. Start the server with python -m src.main --project-dir /path/to/project (required argument). Optionally set log level and log file path. For integration with Claude Desktop or VSCode/Cline, configure the server in the respective MCP settings JSON file.

Key features of MCP File System Server

  • List directory contents with .gitignore filtering
  • Read file contents as string
  • Save files atomically with full content
  • Append content to existing files only
  • Delete files irreversibly within project directory
  • Edit files using pattern matching with dry-run support
  • Structured logging with human-readable and JSON formats

Use cases of MCP File System Server

  • Read existing project code for analysis and recommendations
  • Write new files with AI-generated content
  • Make selective edits to code without rewriting entire files
  • Delete temporary or obsolete files
  • Debug and fix issues by modifying files in place

FAQ from MCP File System Server

What runtime does MCP File System Server require?

Python is required. The recommended setup uses a virtual environment and installs dependencies via pip install -e .. No other external services are needed.

How are file operations secured?

All paths are normalized and validated to remain within the specified project directory. Path traversal attacks are prevented, and writes are atomic to avoid data corruption. Delete operations are also restricted to the project directory.

What tools does MCP File System Server expose?

It exposes six tools: list_directory, read_file, save_file, append_file, delete_this_file, and edit_file. Each tool has specific parameters documented in the README.

How do I integrate MCP File System Server with Claude Desktop or VSCode/Cline?

You add a configuration block to the respective settings JSON file (e.g., claude_desktop_config.json for Claude Desktop or cline_mcp_settings.json for VSCode/Cline), specifying the Python executable, script path, project directory, and optional auto-approve list.

Can I auto-approve certain operations for convenience?

Yes, the autoApprove array in the configuration allows you to skip user approval for selected tools. The README recommends auto-approving only read-only operations like list_directory and read_file for better security.

评论

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

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

shtse8

📄 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

Filesystem MCP Server

cyanheads

A Model Context Protocol (MCP) server for platform-agnostic file capabilities, including advanced search/replace and directory tree traversal

42

File Context Server

bsmi021

A Model Context Protocol (MCP) server that provides file system context to Large Language Models (LLMs). This server enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.

37

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

Mcp Google Sheets

xing5

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

934