Filesystem MCP Server

@sergiobayona

关于 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

基本信息

分类

文件与存储

运行时

ruby

传输方式

stdio

发布者

sergiobayona

配置

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

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.

评论

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

WORK IN PROGRESS - USE WITH CAUTION - Windows:

MCP server for working with PDF files

Filesystem MCP Server

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

Google Drive MCP Server

A google drive mcp servers based on Python

md-pdf-mcp (Markdown to PDF MCP Server)

Markdown To PDF Conversion MCP

Mcp Directory

directory for Awesome MCP Servers