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 linterを実行する

• ruff_format(paths) - ruff を使用してファイルをフォーマットする

コマンド実行

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

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