Mcp Filesystem

Name: Mcp Filesystem
Author: gabrielmaialva33

@gabrielmaialva33

リポジトリホームページ

Mcp Filesystem について

A secure Model Context Protocol (MCP) server providing filesystem access within predefined directories

#server #filesystem #mcp #mcp-server

基本情報

カテゴリ

ファイルとストレージ

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

gabrielmaialva33

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-filesystem": {
      "command": "npx",
      "args": [
        "@gabrielmaialva33/mcp-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Mcp Filesystem?

Mcp Filesystem is a secure Model Context Protocol (MCP) server that provides controlled filesystem access for AI models. It enforces strict path validation and only allows operations within predefined directories, making it suitable for applications needing safe file read/write capabilities.

How to use Mcp Filesystem?

Install via npm (npx @gabrielmaialva33/mcp-filesystem) or clone the repository and build locally. Run the server by specifying allowed directory paths as arguments (e.g., mcp-filesystem /path/to/allowed/dir). Optionally use a JSON configuration file with --config=config.json. Integrate with Claude Desktop by adding a filesystem entry in claude_desktop_config.json.

Key features of Mcp Filesystem

Secure access with strict path validation
Read, write, edit, and move files
Create, list, and search directory contents
Recursive directory tree view
Secure system command execution (v0.3.1+)
Docker and Docker Compose support
Structured logging and performance metrics (v0.3.0+)
Configurable file size and symlink policies

Use cases of Mcp Filesystem

AI assistants reading and editing local project files within trusted directories
Automated file management and directory browsing by language models
Secure execution of shell commands on allowed paths for workflow automation
Integration with MCP‑compatible clients (e.g., Claude Desktop) for filesystem operations

FAQ from Mcp Filesystem

What is Mcp Filesystem?

It is a secure MCP server that gives AI models controlled access to files and directories, preventing unauthorized path traversal by only permitting operations inside explicitly allowed directories.

How do I install and run Mcp Filesystem?

You can install it globally via npm (npm install -g @gabrielmaialva33/mcp-filesystem) or use npx without installation. Run the server by passing one or more directory paths as arguments. A configuration file can be created with --create-config=config.json.

What tools does Mcp Filesystem provide?

It offers file operations (read, write, edit, move), directory operations (create, list, tree, search), file metadata retrieval, secure command execution, and HTTP requests (coming in v1.2.0). Performance metrics and logging are available from v0.3.0.

How do I configure Mcp Filesystem with Claude Desktop?

Add an entry to claude_desktop_config.json under mcpServers with the command mcp-filesystem (or npx @gabrielmaialva33/mcp-filesystem) and list allowed directories as arguments. Docker usage is also supported with volume mounts.

What configuration options are available?

You can set allowed directories, log level, log file path, server name/version, caching settings (enabled, maxSize, ttlMs), metrics reporting interval, and security constraints like max file size (default 10 MB) and symlink handling. See the example config.json in the README.