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

ファイルシステム操作用のモデルコンテキストプロトコル (MCP) を実装する Go サーバー。

特徴

• ファイルの読み取り/書き込み

• ディレクトリの作成/一覧表示/削除

• ファイル/ディレクトリを移動する

• ファイルを検索

• ファイルのメタデータを取得する

• ディレクトリツリー構造を生成する

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

Related MCP server: File Operations MCP Server

API

リソース

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

ツール

• 読み取りファイル

  • ファイルの完全な内容を読み取る

  • 入力: path (文字列)

  • UTF-8エンコードでファイル内容全体を読み取ります

• 複数のファイルを読み取る

  • 複数のファイルを同時に読み取る

  • 入力: paths (文字列[])

  • 読み取りに失敗しても操作全体が停止することはない

• 書き込みファイル

  • 新しいファイルを作成するか、既存のファイルを上書きします（注意が必要です）

  • 入力:

    • path （文字列）: ファイルの場所

    • content (文字列): ファイルの内容

• ディレクトリの作成

  • 新しいディレクトリを作成するか、存在することを確認します

  • 入力: path (文字列)

  • 必要に応じて親ディレクトリを作成します

  • ディレクトリが存在する場合は、何もせずに成功します

• リストディレクトリ

  • [FILE]または[DIR]プレフィックスを持つディレクトリの内容を一覧表示します

  • 入力: path (文字列)

• ファイルの移行

  • ファイルとディレクトリの移動または名前の変更

  • 入力:

    • source （文字列）

    • destination （文字列）

  • 宛先が存在する場合は失敗します

• 検索ファイル

  • ファイル/ディレクトリを再帰的に検索する

  • 入力:

    • path （文字列）：開始ディレクトリ

    • pattern (文字列): 検索パターン

  • 大文字と小文字を区別しないマッチング

  • 一致するフルパスを返します

• ファイル情報を取得する

  • 詳細なファイル/ディレクトリのメタデータを取得する

  • 入力: path (文字列)

  • 戻り値:

    • サイズ

    • 作成時間

    • 修正時間

    • アクセス時間

    • タイプ（ファイル/ディレクトリ）

    • 権限

• 木

  • ディレクトリ構造の階層的なJSON表現を返します

  • 入力:

    • path （文字列）：走査するディレクトリ（必須）

    • depth （数値）：トラバースする最大深さ（デフォルト：3）

    • follow_symlinks (ブール値): シンボリックリンクをたどるかどうか (デフォルト: false)

  • ファイル/ディレクトリ階層を含むフォーマットされたJSONを返します

  • ファイルのメタデータ（名前、パス、サイズ、変更時刻）が含まれます

• 許可されたディレクトリの一覧

  • サーバーがアクセスを許可されているすべてのディレクトリを一覧表示します

  • 入力不要

  • 戻り値:

    • このサーバーが読み取り/書き込みできるディレクトリ

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ライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。