File

io.github.rog0xPublished by GitHub account rog0xv1.0.1Updated Oct 24, 2026

Dir tree, file stats, duplicates, LOC for AI agents

VerifiedSTDIODesktop onlyFiles & StorageDeveloper Tools

Overview

AI-generated overview

Lets an assistant inspect local directories: directory trees, file statistics, duplicate detection, line-of-code counts, and file search.

What you can do
This local MCP server exposes five read-only analysis tools for file systems. dir_tree renders a visual directory tree with configurable depth and ignore patterns; file_stats summarizes a directory with totals, size breakdown by extension, and largest, newest, and oldest files. duplicate_finder groups duplicates by size and MD5 hash and reports wasted space, code_counter counts code, comment, and blank lines across 20+ languages, and file_search matches files by name glob, content regex, size, and modification date.
When to use it
Useful when an assistant needs to understand a codebase or folder layout, audit disk usage, find duplicated files, measure project size by language, or locate files by name, content, or date without manual shell commands.
Requirements
Runs locally over stdio as an npm package (@rog0x/mcp-file-tools) and needs Node.js; the README describes cloning the repository, running npm install and npm run build, then registering the built dist/index.js with an absolute path in the client configuration. Desktop only; no authentication, environment variables, or headers are declared.
Before you install
Tools read local files and directory contents, including file contents for regex search and hashing, so results may expose sensitive paths or data to the assistant. It is read-only and does not modify, move, or delete files. Directory paths are supplied as absolute paths, so scope access carefully.

Installation

In SourceWeft

  1. Open File in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@rog0x/mcp-file-tools

MCP server providing file and directory analysis tools for AI agents. Gives Claude (and other MCP-compatible AI) the ability to explore, analyze, and search file systems.

Tools

ToolDescription
dir_treeGenerate a visual directory tree structure with configurable depth and ignore patterns
file_statsAnalyze a directory: total files, size breakdown by extension, largest/newest/oldest files
duplicate_finderFind duplicate files by size + MD5 hash, report wasted space
code_counterCount lines of code by language: code, comments, and blank lines (like cloc/scc)
file_searchSearch files by name glob, content regex, size range, and date range

Installation

bash
git clone https://github.com/rog0x/mcp-file-tools.gitcd mcp-file-toolsnpm installnpm run build

Configuration

Claude Code

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

Claude Desktop

Add to your claude_desktop_config.json:

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

Tool Details

dir_tree

Generate a visual directory tree like the tree command.

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

Get a comprehensive analysis of a directory's contents.

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

Returns: total files, total size, file counts by extension, top 10 largest files, top 10 newest/oldest files.

duplicate_finder

Find duplicate files using size pre-filtering and MD5 hashing.

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)

Returns: duplicate groups with file paths, sizes, and total wasted space.

code_counter

Count lines of code across 20+ languages with comment detection.

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

Supported languages: TypeScript, JavaScript, Python, Java, C/C++, C#, Go, Rust, Ruby, PHP, Swift, Kotlin, HTML, CSS, JSON, YAML, Markdown, Shell, SQL, Lua.

file_search

Search for files using multiple criteria simultaneously.

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)

License

MIT

Source: README.md at commit c917eca

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts