rog0x avatar

File

rog0x/mcp-file-tools

Gives Claude filesystem analysis capabilities through five tools: dir_tree for visual directory structures, file_stats for size breakdowns and file counts by extension, duplicate_finder using MD5 hashing to identify redundant files, code_counter supporting 20+ languages with comment detection, and file_search with glob patterns, regex content matching, and size/date filtering. Runs via Node.js stdio transport. Reach for this when you need Claude to audit codebases, find duplicate assets, generate project documentation, or answer questions about file organization without manually gathering that data yourself. Built on standard filesystem operations with configurable depth limits and ignore patterns.

tools
5
transport
STDIO
last updated
Mar 22, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

dir_treeGenerate a visual directory tree structure with configurable depth and ignore patterns

Generate a visual directory tree structure with configurable depth and ignore patterns

No parameter schema in public metadata yet.

file_statsAnalyze a directory: total files, size breakdown by extension, largest/newest/oldest files

Analyze a directory: total files, size breakdown by extension, largest/newest/oldest files

No parameter schema in public metadata yet.

duplicate_finderFind duplicate files by size + MD5 hash, report wasted space

Find duplicate files by size + MD5 hash, report wasted space

No parameter schema in public metadata yet.

code_counterCount lines of code by language: code, comments, and blank lines (like cloc/scc)

Count lines of code by language: code, comments, and blank lines (like cloc/scc)

No parameter schema in public metadata yet.

file_searchSearch files by name glob, content regex, size range, and date range

Search files by name glob, content regex, size range, and date range

No parameter schema in public metadata yet.

Sponsors

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

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

Configuration

Claude Code

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:


View the full README on GitHub

Details

Repository
github.com/rog0x/mcp-file-tools
Package
@rog0x/mcp-file-tools
Transport
STDIO
Registry
MCP registry, active

More from rog0x