Filesystem MCP Server I1w

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

このサーバは Node.js をベースにしたモデルコンテキストプロトコル（MCP）サーバで、ファイルシステム操作に使用されます。

✨ 主な機能

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

⚠️ 重要提示

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

📚 ドキュメント

🔍 リソース

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

🛠️ ツール

• read_file

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

• read_multiple_files

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

• write_file

  • 新しいファイルを作成するか、既存のファイルを上書きします（この機能を使用する際は注意が必要です）。
  • 入力：
    • path（文字列）：ファイルパス
    • content（文字列）：ファイル内容

• edit_file

  • 高度なパターンマッチングとフォーマットを使用して選択的に編集します。
  • 機能：
    • 行内内容のマッチングと複数行内容のマッチング
    • インデントを保持した空白文字の正規化
    • 信頼度スコア付きの曖昧マッチング
    • 複数の同時編集と正しい位置決め
    • インデントスタイルの検出と保持
    • Git のような差分出力とコンテキスト
    • 試行運転モードでの変更のプレビュー
    • 信頼度スコアによるマッチング失敗のデバッグ
  • 入力：
    • path（文字列）：編集するファイルのパス
    • edits（配列）：編集操作のリスト
      • oldText（文字列）：検索するテキスト（部分文字列でも可）
      • newText（文字列）：置き換える新しいテキスト
    • dryRun（ブール値）：変更を適用せずにプレビューする（デフォルト：false）
    • options（オブジェクト）：オプションのフォーマット設定
      • preserveIndentation（ブール値）：既存のインデントを保持する（デフォルト：true）
      • normalizeWhitespace（ブール値）：空白文字を正規化する（デフォルト：true）
  • 出力：
    • 編集後のファイル内容

• create_directory

  • 新しいディレクトリを作成します。
  • 入力：path（文字列）

• remove_directory

  • ディレクトリを削除します。
  • 入力：path（文字列）

• list_directories

  • すべてのサブディレクトリを一覧表示します。
  • 入力：path（文字列）
  • 出力：サブディレクトリのパスを含む配列

• rename_file

  • ファイルの名前を変更します。
  • 入力：
    • oldPath（文字列）：旧ファイルパス
    • newPath（文字列）：新ファイルパス

• delete_file

  • ファイルを削除します。
  • 入力：path（文字列）

💻 使用例

基本的な使用法

Claude Desktop で使用するには、claudia.json ファイルに以下の内容を追加します。

{
  "filesystem": {
    "server": "mcp/filesystem",
    "options": {
      "sandboxed_directories": [
        "/path/to/sandbox1",
        "/path/to/sandbox2"
      ]
    }
  }
}

📦 インストール

Docker イメージをビルドするには、以下のコマンドを使用します。

docker build -t mcp/filesystem -f src/filesystem/Dockerfile .

📄 ライセンス

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