English Français العربية

Filesystem

السجل الرسمي أخرى

Read, create, and edit files.

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

التثبيت

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

NPM package filesystem-mcp
Claude Code 
claude mcp add filesystem -- npx -y filesystem-mcp@1.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "filesystem": {
            "command": "npx",
            "args": [
                "-y",
                "filesystem-mcp@1.3.0"
            ]
        }
    }
}
NPM package filesystem-mcp
Claude Code 
claude mcp add filesystem -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -- npx -y filesystem-mcp@1.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "filesystem": {
            "command": "npx",
            "args": [
                "-y",
                "filesystem-mcp@1.3.0"
            ],
            "env": {
                "MCP_TRANSPORT": "<MCP_TRANSPORT>"
            }
        }
    }
}

متغيرات البيئة

  • MCP_TRANSPORT إلزامي Transport type.

التوثيق

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

المحتويات
  1. filesystem-mcp
  2. Use Cases
  3. Setup
  4. Tools
  5. Contributing
  6. Releases

filesystem-mcp

MCP server for filesystem operations - read, create, and edit files.

Use Cases

Save email attachments: "Download all PDFs from my accountant's emails this month" → searches Gmail for matching emails, extracts attachments, and saves them to a local folder.

Update config files: "Change the API endpoint from staging to production in my config" → finds the config file, replaces the URL, and shows you the diff.

Generate reports: "Create a summary of today's calendar events" → reads your calendar, formats a markdown report, and saves it to your notes folder.

Code refactoring: "Rename the function getData to fetchUserData in src/api.ts" → reads the file, makes the precise replacement, and confirms the change.

Backup before changes: "Save a copy of my .zshrc before I modify it" → reads the current file and writes a timestamped backup.

Setup

Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Tools

ToolDescription
viewRead file contents or list directory (with line numbers)
createCreate or overwrite a file
str_replaceReplace an exact string in a file
insertInsert text at a specific line

Contributing

Pull requests are welcomed on GitHub! To get started:

  1. Install Git and Node.js
  2. Clone the repository
  3. Install dependencies with npm install
  4. Run npm run test to run tests
  5. Build with npm run build

Releases

Versions follow the semantic versioning spec.

To release:

  1. Use npm version <major | minor | patch> to bump the version
  2. Run git push --follow-tags to push with tags
  3. Wait for GitHub Actions to publish to the NPM registry.

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

ما هو Filesystem؟

Read, create, and edit files.

كيف أثبّت Filesystem؟

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

هل يحتاج Filesystem إلى مفتاح API؟

نعم. يتطلب MCP_TRANSPORT، وتضبطها في إعداداته.

هل Filesystem مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Filesystem؟

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

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