Filesystem MCP Server

ファイルシステム MCP サーバー

vector_mcp gem を使用してファイルシステム操作を行う、Model Context Protocol（MCP）対応の Ruby サーバーです。

機能

• ファイル操作：読み取り、書き込み、編集、移動
• ディレクトリ操作：作成、一覧表示
• フィルタリングと並べ替えに対応した高度な検索
• メタデータの一括操作
• オプションの認証と認可
• MCP roots を使用した安全なファイルシステム境界

インストール

1. Ruby 3.1+ と bundler をインストールします
2. このリポジトリをクローンします
3. bundle install を実行します

使い方

基本モード

ruby file_system_mcp.rb ~/Documents ~/Desktop

セキュアモード（認証あり）

FILESYSTEM_MCP_API_KEY=your-secret-key ruby file_system_mcp.rb --enable-auth ~/Documents

Claude Desktop の設定

claude_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_multiple_files - 複数のファイルを一度に読み取ります
• write_file - ファイルを作成／上書きします
• edit_file - 差分プレビューを使ってテキストを正確に置換します
• move_file - ファイルやディレクトリを移動／名前変更します

ディレクトリ操作

• list_directory - オプションのメタデータとともに内容を一覧表示します
• create_directory - ディレクトリを再帰的に作成します

検索操作

• search_files - パターンを指定した基本的な再帰検索
• find_files - 並べ替え、フィルタリング、メタデータに対応した高度な検索

情報操作

• get_file_info - ファイル／ディレクトリの詳細なメタデータを取得します
• get_bulk_file_info - 複数ファイルのメタデータを効率的に取得します

セキュリティ

このサーバーは MCP roots を使用してファイルシステムの境界を適用します。コマンドライン引数で指定されたディレクトリのみアクセスできます。

オプションの認証を有効にすると、すべての操作で API キーが検証されます。

要件

• Ruby 3.1+
• vector_mcp gem v0.3.1+