English Français العربية

io.github.rog0x/file

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @rog0x/mcp-file-tools
Claude Code 
claude mcp add file -- npx -y @rog0x/mcp-file-tools@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "file": {
            "command": "npx",
            "args": [
                "-y",
                "@rog0x/mcp-file-tools@1.0.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @rog0x/mcp-file-tools
  2. Tools
  3. Installation
  4. Configuration
  5. Tool Details
  6. License

@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:

{
  "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.

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

الأسئلة الشائعة

ما هو io.github.rog0x/file؟

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

كيف أثبّت io.github.rog0x/file؟

يعمل على جهازك. في Claude Code: claude mcp add file -- npx -y @rog0x/mcp-file-tools@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.rog0x/file إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.rog0x/file مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.rog0x/file؟

ينشره rog0x. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.