Mark3labs MCP Filesystem Server

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

ファイルシステム操作に使用される、モデルコンテキストプロトコル（MCP）を実装した Go サーバです。

✨ 主な機能

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

⚠️ 重要提示

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

📚 ドキュメント

API

リソース

• 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（文字列）
  • 返却値：
    • サイズ
    • 作成時間
    • 更新時間
    • アクセス時間
    • タイプ（ファイル/ディレクトリ）
    • 権限

• 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 ライセンスの下で公開されています。これは、MIT ライセンスの条項と条件に従い、自由にソフトウェアを使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。