{
  "markdown": "\n# @rog0x/mcp-file-tools\n\nMCP 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.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `dir_tree` | Generate a visual directory tree structure with configurable depth and ignore patterns |\n| `file_stats` | Analyze a directory: total files, size breakdown by extension, largest/newest/oldest files |\n| `duplicate_finder` | Find duplicate files by size + MD5 hash, report wasted space |\n| `code_counter` | Count lines of code by language: code, comments, and blank lines (like cloc/scc) |\n| `file_search` | Search files by name glob, content regex, size range, and date range |\n\n## Installation\n\n```bash\ngit clone https://github.com/rog0x/mcp-file-tools.git\ncd mcp-file-tools\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### Claude Code\n\n```bash\nclaude mcp add mcp-file-tools node /absolute/path/to/mcp-file-tools/dist/index.js\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-file-tools\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-file-tools/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Tool Details\n\n### dir_tree\n\nGenerate a visual directory tree like the `tree` command.\n\n```\nParameters:\n  dir_path (required)     - Absolute path to the directory\n  max_depth (optional)    - Max depth to traverse (default: 5, 0 = unlimited)\n  ignore_patterns (optional) - Patterns to ignore (default: node_modules, .git, dist, etc.)\n```\n\n### file_stats\n\nGet a comprehensive analysis of a directory's contents.\n\n```\nParameters:\n  dir_path (required)     - Absolute path to the directory\n  max_depth (optional)    - Max depth to traverse (default: 10)\n```\n\nReturns: total files, total size, file counts by extension, top 10 largest files, top 10 newest/oldest files.\n\n### duplicate_finder\n\nFind duplicate files using size pre-filtering and MD5 hashing.\n\n```\nParameters:\n  dir_path (required)     - Absolute path to the directory\n  min_size (optional)     - Minimum file size in bytes (default: 1)\n  max_depth (optional)    - Max depth to traverse (default: 10)\n```\n\nReturns: duplicate groups with file paths, sizes, and total wasted space.\n\n### code_counter\n\nCount lines of code across 20+ languages with comment detection.\n\n```\nParameters:\n  dir_path (required)     - Absolute path to the directory\n  max_depth (optional)    - Max depth to traverse (default: 10)\n```\n\nSupported languages: TypeScript, JavaScript, Python, Java, C/C++, C#, Go, Rust, Ruby, PHP, Swift, Kotlin, HTML, CSS, JSON, YAML, Markdown, Shell, SQL, Lua.\n\n### file_search\n\nSearch for files using multiple criteria simultaneously.\n\n```\nParameters:\n  dir_path (required)        - Absolute path to the directory\n  name_pattern (optional)    - Glob pattern (e.g. \"**/*.ts\")\n  content_pattern (optional) - Regex to search file contents\n  min_size (optional)        - Minimum file size in bytes\n  max_size (optional)        - Maximum file size in bytes\n  modified_after (optional)  - ISO date string\n  modified_before (optional) - ISO date string\n  max_results (optional)     - Max results (default: 100)\n```\n\n## License\n\nMIT\n",
  "bytes": 3216,
  "sha": "99b329258d933a01ed24beb02e529c74191efdebcde8f7945a9fda97aa5e930e",
  "repo_slug": "rog0x/mcp-file-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rog0x_file_72916eb9/readme"
}