
File
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 toolsPublic 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
| 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:
Details
- Repository
- github.com/rog0x/mcp-file-tools
- Package
@rog0x/mcp-file-tools- Transport
- STDIO
- Registry
- MCP registry, active