Filesystem MCP Server
About
Ruby server implementing Model Context Protocol (MCP) for filesystem operations using the https://rubygems.org/gems/vector_mcp gem.
Details
- Author
- sergiobayona
- GitHub stars
- 1
- Downloads
- 395
- Categories
- File Management, Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Filesystem MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"filesystem mcp server": {
"filesystem": {
"command": "ruby",
"args": [
"/Users/your_username/file_system_mcp/file_system_mcp.rb",
"/Users/your_username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
}McpServers
{
"filesystem": {
"command": "ruby",
"args": [
"/Users/your_username/file_system_mcp/file_system_mcp.rb",
"/Users/your_username/Desktop",
"/path/to/other/allowed/dir"
]
}
}Ruby server implementing Model Context Protocol (MCP) for filesystem operations using thevector_mcpgem.
- File operations: read, write, edit, move
- Directory operations: create, list
- Advanced search with filtering and sorting
- Bulk metadata operations
- Optional authentication and authorization
- Secure filesystem boundaries using MCP roots
- Install Ruby 3.1+ and bundler
- Clone this repository
- Runbundle install
ruby file_system_mcp.rb ~/Documents ~/Desktop
FILESYSTEM_MCP_API_KEY=your-secret-key ruby file_system_mcp.rb --enable-auth ~/Documents
Add to yourclaude_desktop_config.json:
{ "mcpServers": { "filesystem": { "command": "ruby", "args": [ "/path/to/file_system_mcp.rb", "~/Documents", "~/Desktop" ] } } }
{ "mcpServers": { "filesystem": { "command": "ruby", "args": [ "/path/to/file_system_mcp.rb", "--enable-auth", "~/Documents" ], "env": { "FILESYSTEM_MCP_API_KEY": "your-secret-key" } } } }
- read_file- Read complete file contents
- read_multiple_files- Read multiple files at once
- write_file- Create/overwrite files
- edit_file- Make precise text replacements with diff preview
- move_file- Move/rename files and directories
- list_directory- List contents with optional metadata
- create_directory- Create directories recursively
- search_files- Basic recursive search with patterns
- find_files- Advanced search with sorting, filtering, and metadata
- get_file_info- Get detailed file/directory metadata
- get_bulk_file_info- Get metadata for multiple files efficiently
The server enforces filesystem boundaries using MCP roots - it can only access directories specified as command-line arguments.
Optional authentication adds API key verification for all operations.
Parses various file formats using the 302.AI API, requiring a 302AI_API_KEY.
A local server that allows AI to execute Windows CMD commands, read/write files, and manage directories within a specified path.
Filesystem agent memory working with consolidation Daemon on your machine
An AI-powered MCP server for advanced file system operations, including search, comparison, and security analysis.
Securely browse and read files within an Android project, with built-in validation and access controls for sensitive directories.
Build a persistent, local knowledge base in Markdown files through conversations with LLMs.
A read-only MCP server for querying live FTP data using the CData JDBC Driver.
An MCP server for viewing, editing, and creating text files, based on the Claude built-in text editor tool.
Convert PDF, Word, Excel, PowerPoint, EPUB, HEIC and images from Claude or Cursor, with 35 converters exposed through just two MCP tools.
A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
