Readonly Filesystem MCP

🚀 読み取り専用ファイルシステムMCPサーバー

Node.jsベースのサーバーで、モデルコンテキストプロトコル（MCP）を実装し、読み取り専用のファイル操作を行います。このサーバーは、modelcontextprotocol/server-filesystem からクローンされたものです。

✨ 主な機能

• ファイルの読み取り
• ディレクトリの一覧表示
• ファイルの検索
• ファイルメタデータの取得

⚠️ 重要提示

サーバーは、args で指定されたディレクトリ内での操作のみを許可します。

📚 ドキュメント

🔍 リソース

• file://system：ファイルシステム操作インターフェース

🛠️ ツール

• read_file

  • ファイルの内容を完全に読み取ります。
  • 入力:
    • path（文字列）：読み取るファイルのパス
    • from（数値）：オプション。読み取りを開始する行番号。デフォルトは0です。
    • to（数値）：オプション。読み取りを終了する行番号。指定しない場合は、ファイルの末尾まで読み取ります。
  • UTF - 8エンコーディングでファイル内容を（完全または部分的に）読み取ります。

• read_multiple_files

  • 複数のファイルを同時に読み取ります。
  • 入力: paths（文字列配列）
  • 読み取りに失敗しても、全体の操作は中止されません。

• list_directory

  • ディレクトリの内容を [FILE] または [DIR] の接頭辞付きで一覧表示します。
  • 入力: path（文字列）

• search_files

  • ファイル/ディレクトリを再帰的に検索します。
  • 入力:
    • path（文字列）：検索を開始するディレクトリ
    • pattern（文字列）：検索パターン
    • excludePatterns（文字列配列）：一致するパターンを除外します。glob形式をサポートします。
  • 大文字と小文字を区別しない一致を行います。
  • 完全な一致パスを返します。

• get_file_info

  • ファイル/ディレクトリの詳細なメタデータを取得します。
  • 入力: path（文字列）
  • 返り値:
    • サイズ
    • 作成時間
    • 変更時間
    • アクセス時間
    • タイプ（ファイル/ディレクトリ）
    • 権限

• list_allowed_directories

  • サーバーがアクセスを許可されているすべてのディレクトリを一覧表示します。
  • 入力は不要です。
  • 返り値:
    • このサーバーが読み取り/書き込みできるディレクトリ

💻 使用例

Claude Desktopでの使用方法

claude_desktop_config.json に以下の内容を追加します。

💡 使用建议

ディレクトリを /projects にマウントすることで、サーバーに制限されたディレクトリを提供できます。ro フラグを追加すると、サーバーはそのディレクトリを読み取り専用でアクセスします。

NPX

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@danielsuguimoto/readonly-server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

📄 ライセンス

このMCPサーバーは、MIT Licenseに基づいて配布されています。これは、あなたが自由にこのソフトウェアを使用、変更、配布できることを意味しますが、MIT Licenseの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。