MCP.so
Sign In

Filesystem MCP Server

@sergiobayona

Repository

About Filesystem MCP Server

Ruby server implementing Model Context Protocol (MCP) for filesystem operations using the https://rubygems.org/gems/vector_mcp gem.

#mcp#mcp-server

Basic information

Category

Files & Storage

Runtime

ruby

Transports

stdio

Publisher

sergiobayona

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "filesystem": {
      "command": "ruby",
      "args": [
        "/Users/your_username/file_system_mcp/file_system_mcp.rb",
        "/Users/your_username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Filesystem MCP Server?

Filesystem MCP Server is a Ruby server implementing the Model Context Protocol (MCP) for filesystem operations. It integrates with the vector_mcp gem to provide file and directory manipulation, search, and metadata tools while enforcing secure filesystem boundaries via MCP roots.

How to use Filesystem MCP Server?

Install Ruby 3.1+ and bundler, clone the repository, run bundle install, then invoke with directories as arguments (e.g., ruby file_system_mcp.rb ~/Documents ~/Desktop). For secure mode, set the FILESYSTEM_MCP_API_KEY environment variable and add --enable-auth. Configure with Claude Desktop by editing claude_desktop_config.json.

Key features of Filesystem MCP Server

  • File read, write, edit, and move operations
  • Directory creation and listing with metadata
  • Recursive search with pattern matching
  • Advanced search with sorting and filtering
  • Bulk metadata retrieval for multiple files
  • Optional authentication via API key

Use cases of Filesystem MCP Server

  • Read and edit files programmatically through MCP
  • Move or rename files and directories within allowed roots
  • Search and filter files by name, type, or metadata
  • Manage project files with Claude Desktop integration
  • Securely expose local directories with boundaries enforcement

FAQ from Filesystem MCP Server

What are the runtime requirements?

Ruby 3.1+ and the vector_mcp gem version 0.3.1 or later.

How does Filesystem MCP Server enforce security?

It uses MCP roots to restrict access to only the directories specified as command-line arguments. Optional authentication adds API key verification.

Can I use authentication with the server?

Yes, by setting FILESYSTEM_MCP_API_KEY and passing --enable-auth, all operations require a valid API key.

How do I configure Filesystem MCP Server with Claude Desktop?

Add it to claude_desktop_config.json under mcpServers with the command ruby and arguments pointing to the script and allowed directories.

Does the server support editing files?

Yes, the edit_file tool allows precise text replacements with a diff preview.

Comments

More Files & Storage MCP servers

Rust MCP Filesystem

rust-mcp-stack

Blazing-fast, asynchronous MCP server for seamless filesystem operations.

163

mcp-rquest

xxxbrian

A MCP server providing realistic browser-like HTTP request capabilities with accurate TLS/JA3/JA4 fingerprints for bypassing anti-bot measures. It also supports converting PDF and HTML documents to Markdown for easier processing by LLMs.

48

Sample S3 Model Context Protocol Server

aws-samples

78

WORK IN PROGRESS - USE WITH CAUTION - Windows:

hanweg

MCP server for working with PDF files

74

MCP File System Server

MarcusJellinghaus

MCP Workspace Server: A secure Model Context Protocol server providing file, git, and GitHub tools for AI assistants within a sandboxed project directory.

49