MCP File System Server

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

ファイルシステム操作を提供する MCP サーバーです。ファイルやディレクトリの移動、読み取り、書き込み、分析、およびコマンドの実行に対応しています。

ツール

ファイルとディレクトリの操作

• ls(path) - ディレクトリの内容を一覧表示します
• cd(path) - 作業ディレクトリを変更します（~ によるホームディレクトリの展開に対応）
• read_file(path) - ファイルの内容を読み取ります
• write_file(path, content) - ファイルに内容を書き込みます
• mkdir(path) - ディレクトリを作成します
• rm(path) - ファイルまたは空のディレクトリを削除します
• rmdir(path) - ディレクトリとその内容を再帰的に削除します
• cp(src, dst) - ファイルまたはディレクトリをコピーします
• mv(src, dst) - ファイルまたはディレクトリを移動します

編集と検索

• edit_file(path, changes) - ファイルに複数の検索／置換操作を適用します。changes は (search_text, replace_text) のタプルのリストです
• grep(pattern, path) - ファイル内で正規表現パターンを検索します

分析

• summary(path) - Python（.py）ファイルと Markdown（.md）ファイルの概要を生成します：
  • Python：関数とクラスを一覧表示します
  • Markdown：見出し（# で始まる行）を一覧表示します

一括操作

• read_files(paths) - 複数のファイルを読み取り、パスと内容を対応付けた辞書を返します
• summarize(paths) - 複数のファイルの概要を生成し、パスと概要を対応付けた辞書を返します

プロジェクト内の移動

• work_on(path) - ディレクトリに移動して内容を一覧表示し、CLAUDE.md のメモを取得します。 チャットの開始時にプロジェクトの概要を把握するのに便利です

コード品質

• ruff_check(paths) - 指定したファイルに対して ruff リンターを実行します
• ruff_format(paths) - ruff を使用してファイルをフォーマットします

コマンドの実行

• shell_command(command, args=None, cmdline=None, timeout=30) - シェルコマンドを実行し、その出力を取得します

  ⚠️ セキュリティに関する警告：このツールを使用すると、ホストシステム上で任意のコマンドを実行できます。コマンドの実行を許可する前に、必ず内容を確認して検証してください。特に、入力元が信頼できない場合は注意が必要です。