Summary
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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
@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
| Tool | Description |
|---|---|
dir_tree | Generate a visual directory tree structure with configurable depth and ignore patterns |
file_stats | Analyze a directory: total files, size breakdown by extension, largest/newest/oldest files |
duplicate_finder | Find duplicate files by size + MD5 hash, report wasted space |
code_counter | Count lines of code by language: code, comments, and blank lines (like cloc/scc) |
file_search | Search 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:
{
"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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →