# exoticknight/mcp-file-merger [Health: Active]

**Category:** 📂 File Systems  
**Repository:** https://github.com/exoticknight/mcp-file-merger  
**GitHub Stars:** 28  
**npm Downloads (last month):** 64  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/exoticknight-mcp-file-merger

## Description
File merger tool, suitable for AI chat length limits.

## Tools
Capabilities this server exposes over MCP:

- **merge_files** — Merge multiple files into a single output file. Reads content from each input file in the order provided and writes it sequentially to the output file. Returns information about the merge operation including file sizes and total size. All specified paths must be within allowed directories if specified.
- **list_allowed_directories** — Returns the list of directories that this server is allowed to access. Use this to understand which directories are available before trying to merge files.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-file-merger": {
    "command": "npx",
    "args": ["-y","@exoticknight/mcp-file-merger"]
  }
}
```

## Documentation

## What exoticknight/mcp-file-merger MCP server does

The exoticknight/mcp-file-merger MCP server provides a small file-combination utility for MCP-compatible clients. It works with files on the local filesystem and produces one output file from a supplied list of input paths. The input order is preserved: content from the first path is written first, followed by the next path, and so on.

This fits the 📂 File Systems category because its primary operation reads and writes local files. A practical use case is preparing several source files as one file before giving them to an AI assistant subject to chat or context-length limits. The server also returns merge information, including individual file sizes and the combined size.

## How it works

The main operation accepts an `inputPaths` string array and an `outputPath` string. It reads each input file in sequence and writes the contents into the destination. The result includes a success message with details about the completed merge.

Access is bounded by directories supplied when the process starts. The server checks that specified paths are within the allowed locations when directory restrictions are configured. Before attempting a merge, an agent can call `list_allowed_directories` to discover the directories it may access.

The exoticknight/mcp-file-merger MCP server does not describe file transformation, parsing, filtering, or format conversion. Its documented behavior is sequential concatenation into a single file.

## Setup and configuration

1. Clone the repository.
2. Change into the project directory.
3. Run `npm install`.
4. Run `npm run build`.

For Claude Desktop, add an MCP server entry that runs the package with `npx -y @exoticknight/mcp-file-merger` followed by one or more allowed directory paths. The provided example uses `/path/to/allowed/dir`; replace it with a directory appropriate for the files the client should access.

The documented configuration uses command-line arguments rather than environment variables. The allowed-directory arguments define the filesystem scope exposed to the server.

## Tools and capabilities

The exoticknight/mcp-file-merger MCP server exposes two tools:

- `merge_files`: Takes `inputPaths` and `outputPath`, combines the inputs in their listed order, writes the result, and reports file and total-size information.
- `list_allowed_directories`: Lists the directories available to the server so an agent can select valid paths before merging.

These tools support a straightforward workflow: inspect the permitted directories, choose input files, provide an output location, and review the merge result.

## Limitations and notes

The material documents local file access and directory restrictions, but does not specify support for remote storage, file globbing, separators between files, encoding controls, duplicate handling, or overwrite behavior. Applications that require those features should verify the implementation before relying on them.

The repository is licensed under Apache License 2.0. The README specifically documents Claude Desktop configuration; other clients may require their own MCP setup format.

_Full upstream README: https://allmcps.com/mcp/exoticknight-mcp-file-merger/readme_