# ellmos FileCommander

Gives AI agents 50 local tools for filesystem access, background search, process control, and interactive REPL sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: ellmos-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ellmos-ai/ellmos-filecommander-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/ellmos-filecommander

## What it does

The server exposes 50 utilities namespaced with the `fc_` prefix over standard stdio transport. Beyond simple file edits, it manages operating system processes, runs interactive shell or Python REPL sessions, and handles text searches across explicit file lists without unexpected glob expansions.

File deletion defaults to the platform recycle bin or trash folder to prevent accidental data loss. When dealing with cloud sync drives such as OneDrive or Dropbox, the server detects sync locks and falls back to a copy-then-delete routine. It also handles ZIP archives, data format conversions across JSON, YAML, XML, or TOML, and checksum generation up to SHA-512.

Running this server requires Node.js 20 or newer on your machine. Optical character recognition features depend on an optional `tesseract.js` installation.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ellmos-filecommander-mcp -- npx -y ellmos-filecommander-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add ellmos-filecommander -- npx -y ellmos-filecommander-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ellmos-filecommander": {
            "command": "npx",
            "args": [
                "-y",
                "ellmos-filecommander-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ellmos-filecommander": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ellmos-filecommander-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ellmos-filecommander npx -y ellmos-filecommander-mcp
```

## When to use it
- send deleted files to the system trash instead of wiping them permanently
- manage local background processes and interactive REPL environments
- search literal text across an explicit file list without recursive globs
- convert structured data between JSON, YAML, TOML, XML, and CSV

## Example prompts
- Search for the string "DATABASE_URL" across the files listed in targets.txt
- Start a Node.js REPL session and inspect process.env values
- Safely move the unused builds folder to the system recycle bin

## Similar
- [Filesystem MCP](https://affpapa.org/en/nevibecode/mcp/filesystem-mcp.md) — MCP server · ★ 26
- [liteparse](https://affpapa.org/en/nevibecode/skills/liteparse.md) — skill · 4100 installs
- [image-to-editable-ppt](https://affpapa.org/en/nevibecode/skills/image-to-editable-ppt.md) — skill · 1900 installs
- [pdf-to-markdown](https://affpapa.org/en/nevibecode/skills/pdf-to-markdown.md) — skill · 831 installs
- [vision-multimodal](https://affpapa.org/en/nevibecode/skills/vision-multimodal.md) — skill · 550 installs
- [nutrient-document-processing](https://affpapa.org/en/nevibecode/skills/nutrient-sdk-nutrient-document-processing.md) — skill · 470 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md