filemanager

This MCP server implements a powerful File Manager within Trae IDE, exposing a set of file and directory manipulation operations via the MCP API. It supports basic operations like creating, reading, writing, deleting, copying, moving, and listing files and directories, as well as advanced features such as template-based file creation, project structure generation, and batch file operations. You can invoke these capabilities through the provided MCP API calls (for example, create_file, read_file, list_directory, batch_create_files, etc.) to automate common file management tasks inside your workspace. The server also offers enhanced editing and reading modes, including append/prepend/insert edits, encoding options, line or byte-specific reads, and template-driven content generation, making it suitable for building sophisticated file workflows within the IDE.

To use it, configure the MCP server in Trae IDE with the appropriate command (the default setup uses npx to run the package) and then issue actions through the MCP API payloads. Examples include creating a new configuration file, copying files, searching for files with wildcards, or generating a React project structure. The API surface is documented in the API Reference section of the readme, covering individual operations (create_file, read_file, search_files, etc.), batch operations, and advanced features like create_from_template and create_project_structure. By composing these calls, you can automate repetitive file tasks and integrate file management into larger workflows within the IDE.

Prerequisites:

• Node.js and npm installed on your system
• Access to the internet to install packages from npm registry

1. Global installation (recommended):

npm install -g filemanager-mcp-server

2. Project-local installation:

npm install filemanager-mcp-server

3. Configure the MCP service in Trae IDE using either the global install path or a local project path. The following examples show common configurations.

Using npx (recommended):

{
  "mcpServers": {
    "filemanager": {
      "command": "npx",
      "args": [
        "-y",
        "filemanager-mcp-server"
      ]
    }
  }
}

If the above method doesn’t work, you can clone the repository and run locally:

git clone https://github.com/yourusername/filemanager-mcp-server.git
cd filemanager-mcp-server
npm install

Then configure MCP to run directly from the local path with Node:

{
  "mcpServers": {
    "filemanager": {
      "command": "node",
      "args": ["node_modules/filemanager-mcp-server/index.js"]
    }
  }
}

4. Verify installation by starting Trae IDE and loading the MCP configuration. Use the provided API calls to interact with the server.

Tips and notes:

• All paths are resolved to absolute paths internally; you can rely on consistent path handling.
• When creating files, necessary parent directories are automatically created.
• Delete operations are irreversible; use with caution.
• Supports UTF-8 encoded text files.
• The search function supports wildcard patterns (e.g., *).
• Environment variables can be used for customization (e.g., encoding, default templates, backup behavior) depending on your deployment.
• The API reference includes examples for basic, batch, and advanced operations; consult it when composing MCP payloads to perform complex tasks.