MCP Filesystem Server

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

Go言語で実装されたモデルコンテキストプロトコル（MCP）のファイルシステム操作サーバです。このサーバは、指定されたディレクトリ内でのファイルおよびディレクトリ操作をサポートします。

✨ 主な機能

• ファイルの読み取りと書き込み
• ディレクトリの作成、一覧表示、削除
• ファイルやディレクトリの移動
• ファイルの検索
• ファイルのメタデータ取得
• ディレクトリツリー構造の生成

⚠️ 重要提示

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

📚 ドキュメント

🔌 リソース

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

🛠️ ツール

• read_file

  • ファイルの全内容を読み取ります。
  • 入力：path（文字列）
  • UTF-8 エンコーディングでファイルの全内容を読み取ります。

• read_multiple_files

  • 複数のファイルを同時に読み取ります。
  • 入力：paths（文字列配列）
  • 読み取りに失敗した場合でも、全体の操作は停止しません。

• write_file

  • 新しいファイルを作成するか、既存のファイルを上書きします（この機能は慎重に使用してください）。
  • 入力：
    • path（文字列）：ファイルパス
    • content（文字列）：ファイル内容

• create_directory

  • 新しいディレクトリを作成するか、既に存在する場合は何もしません。
  • 入力：path（文字列）
  • 必要に応じて、親ディレクトリも作成します。
  • ディレクトリが既に存在する場合は、無事に成功します。

• list_directory

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

• move_file

  • ファイルやディレクトリを移動またはリネームします。
  • 入力：
    • source（文字列）
    • destination（文字列）
  • 対象が既に存在する場合は、操作は失敗します。

• search_files

  • ファイルやディレクトリを再帰的に検索します。
  • 入力：
    • path（文字列）：検索を開始するディレクトリ
    • pattern（文字列）：検索パターン
  • 大文字小文字を区別しないマッチングを行います。
  • マッチした項目の完全パスを返します。

• get_file_info

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

• tree

  • ディレクトリ構造の階層的なJSON表現を返します。
  • 入力：
    • path（文字列）：走査するディレクトリ（必須）
    • depth（数値）：走査する最大深度（デフォルト値：3）
    • follow_symlinks（ブール値）：シンボリックリンクを追跡するかどうか（デフォルト値：false）
  • ファイルやディレクトリの階層構造を表示するフォーマット済みのJSONを返します。
  • ファイルのメタデータ（名前、パス、サイズ、更新時間）を含みます。

• list_allowed_directories

  • サーバがアクセスできるすべてのディレクトリを一覧表示します。
  • 入力は不要です。
  • 返り値：
    • サーバが読み取りおよび書き込み可能なディレクトリ

📦 インストール

Claude Desktopでのサーバのインストール

go install github.com/mark3labs/mcp-filesystem-server

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

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": [
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

📄 ライセンス

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