file

@rog0x/mcp-file-tools

AI エージェント向けに、ファイルとディレクトリの分析ツールを提供する MCP サーバーです。Claude（およびその他の MCP 互換 AI）がファイルシステムを探索、分析、検索できるようにします。

ツール

ツール	説明
dir_tree	深さと除外パターンを設定して、視覚的なディレクトリツリー構造を生成します
file_stats	ディレクトリを分析します：ファイル総数、拡張子ごとのサイズの内訳、最大／最新／最古のファイル
duplicate_finder	サイズと MD5 ハッシュで重複ファイルを検出し、無駄な容量を報告します
code_counter	言語ごとにコード行数をカウントします：コード、コメント、空行（cloc/scc と同様）
file_search	ファイル名の glob、コンテンツの正規表現、サイズ範囲、日付範囲でファイルを検索します

インストール

git clone https://github.com/rog0x/mcp-file-tools.git
cd mcp-file-tools
npm install
npm run build

設定

Claude Code

claude mcp add mcp-file-tools node /absolute/path/to/mcp-file-tools/dist/index.js

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "mcp-file-tools": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-file-tools/dist/index.js"]
    }
  }
}

ツールの詳細

dir_tree

tree コマンドのような視覚的なディレクトリツリーを生成します。

Parameters:
  dir_path (required)     - Absolute path to the directory
  max_depth (optional)    - Max depth to traverse (default: 5, 0 = unlimited)
  ignore_patterns (optional) - Patterns to ignore (default: node_modules, .git, dist, etc.)

file_stats

ディレクトリの内容を包括的に分析します。

Parameters:
  dir_path (required)     - Absolute path to the directory
  max_depth (optional)    - Max depth to traverse (default: 10)

返される情報：ファイル総数、合計サイズ、拡張子ごとのファイル数、サイズが大きいファイル上位 10 件、最新／最古のファイル上位 10 件。

duplicate_finder

サイズによる事前フィルタリングと MD5 ハッシュを使用して、重複ファイルを検出します。

Parameters:
  dir_path (required)     - Absolute path to the directory
  min_size (optional)     - Minimum file size in bytes (default: 1)
  max_depth (optional)    - Max depth to traverse (default: 10)

返される情報：ファイルパス、サイズ、無駄になっている合計容量を含む重複グループ。

code_counter

コメントを検出しながら、20 以上の言語のコード行数をカウントします。

Parameters:
  dir_path (required)     - Absolute path to the directory
  max_depth (optional)    - Max depth to traverse (default: 10)

対応言語：TypeScript、JavaScript、Python、Java、C/C++、C#、Go、Rust、Ruby、PHP、Swift、Kotlin、HTML、CSS、JSON、YAML、Markdown、Shell、SQL、Lua。

file_search

複数の条件を同時に使用してファイルを検索します。

Parameters:
  dir_path (required)        - Absolute path to the directory
  name_pattern (optional)    - Glob pattern (e.g. "**/*.ts")
  content_pattern (optional) - Regex to search file contents
  min_size (optional)        - Minimum file size in bytes
  max_size (optional)        - Maximum file size in bytes
  modified_after (optional)  - ISO date string
  modified_before (optional) - ISO date string
  max_results (optional)     - Max results (default: 100)

ライセンス

MIT