How to add File Merger MCP Server to Windsurf

Combine multiple files into one — fast, secure, and limited to directories you allow. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 26★ · stdio · no auth

Windsurf config for File Merger MCP Server

npx -y @exoticknight/mcp-file-merger /path/to/allowed/dir

{
  "mcpServers": {
    "file-merger-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@exoticknight/mcp-file-merger",
        "/path/to/allowed/dir"
      ]
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the File Merger MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5File Merger MCP Server's tools become available to Cascade.

Before you start

Node.js with npx available
One or more allowed directories passed as command arguments

What File Merger MCP Server can do in Windsurf

merge_files

Merges multiple files into one. Inputs: inputPaths (string[]) — files to merge; outputPath (string) — output file location. Returns a success message with merge details.

list_allowed_directories

Lists the directories the server is allowed to access.

Security

The server can only access directories explicitly passed as command arguments at launch. Use the list_allowed_directories tool to confirm which paths are accessible.

File Merger MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the File Merger MCP Server config there under the "mcpServers" key and restart the client.

Is File Merger MCP Server safe to use with Windsurf?

The server can only access directories explicitly passed as command arguments at launch. Use the list_allowed_directories tool to confirm which paths are accessible.

Which directories can the server access?

Only the directories you pass as command-line arguments when launching the server. You can confirm them at any time with the list_allowed_directories tool.

Does it handle large files?

Yes. The README states it efficiently combines files of any size and reports file sizes plus a merge summary.

How do I install it?

Add the mcpServers block to your claude_desktop_config.json using npx with @exoticknight/mcp-file-merger and your allowed directory, or clone the repo and run npm install && npm run build.

View repo Full File Merger MCP Server page