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 Filesystem Server

mark3labs

Go server implementing Model Context Protocol (MCP) for filesystem operations.

664

HTMLvault

AI tools (Claude, ChatGPT, Gemini, Grok, etc.) generate HTML constantly, from reports to landing pages to prototypes, but there's no easy way to share it or know if anyone looked. HTMLvault turns any HTML into a clean, t

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

MCP File System Server について

MCP File System Server の設定

MCP File System Server のツール

list_directory

read_file

save_file

append_file

delete_this_file

edit_file

概要