Filesystem MCP Server

@sergiobayona

リポジトリ

基本情報

カテゴリ

ファイルとストレージ

トランスポート

stdio

作者

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

Filesystem MCP Server の設定

以下の設定を使って、このサーバーを 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"
      ]
    }
  }
}

Filesystem MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは 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

よくある質問

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 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.

PDF Reader MCP Server (@shtse8/pdf-reader-mcp)

shtse8

📄 The PDF intelligence layer for AI agents — Agent Document Twin, evidence-first extraction, visual crops, OCR provenance, trust reports, and benchmark-gated releases. MCP server for Claude, Cursor, VS Code, and any MCP client.

810