English Français العربية

io.github.CloudCorpRecords/fileport

Official registry Search and web

Sandboxed file access: read, write, edit and search in allowed dirs.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @reneturcios/fileport
Claude Code 
claude mcp add fileport -- npx -y @reneturcios/fileport@0.1.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "fileport": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/fileport@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/fileport:0.1.0
Claude Code 
claude mcp add fileport -- docker run -i --rm ghcr.io/cloudcorprecords/fileport:0.1.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "fileport": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/fileport:0.1.0",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. fileport
  2. Install
  3. Allowed directories
  4. CLI
  5. MCP server
  6. Development
  7. License

fileport

fileport gives an agent careful, sandboxed access to the local filesystem. It can read and write text, return media as base64, apply exact-match edits, walk directory trees, and search by glob — but only inside the directories you allow. Anything outside those roots is refused, including paths that escape through .. segments or symlinks.

Install

npx @reneturcios/fileport list .

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/fileport

The container defaults to the MCP server. Pass CLI arguments to use it as a CLI instead.

Allowed directories

The sandbox is the whole point of this tool, so it is configured explicitly:

  • fileport mcp /data/docs /data/notes — the arguments after mcp are the allowed roots.
  • FILEPORT_ROOTS — a path-delimiter-separated list used when no arguments are given.
  • With neither set, the current working directory is the only root.

Every path a tool receives is canonicalised (symlinks resolved; new files resolved through their parent) and checked against the roots before any read or write happens.

CLI

fileport list <path>     # entries as [FILE] / [DIR] lines
fileport read <path>     # print a file's text contents
fileport mcp [dirs...]   # start the stdio MCP server
fileport --version

Exit codes: 0 on success, 1 when an operation fails (for example a path outside the allowed directories), 2 for usage errors. The list and read helpers resolve paths against the working directory.

MCP server

npx -y @reneturcios/fileport mcp /path/to/allowed/dir

MCP client configuration:

{
  "mcpServers": {
    "fileport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/fileport", "mcp", "/path/to/allowed/dir"]
    }
  }
}
Tools
ToolInputWhat it returns
read_filepathThe file's full text contents.
read_text_filepath, optional head or tail (line counts, mutually exclusive)The file text, or just its first/last lines.
read_media_filepathBase64 image, audio, or blob content chosen by extension.
read_multiple_filespathsEach file's contents; a failure for one file is reported in-band and does not stop the others.
write_filepath, contentWrites the text, creating parent folders as needed.
edit_filepath, edits (oldText/newText pairs), optional dryRunApplies each exact-match replacement, or returns a diff-like preview when dryRun is set. Errors if an oldText is not found.
create_directorypathCreates the directory and any missing parents.
list_directorypathEntries as [FILE] name / [DIR] name lines.
list_directory_with_sizespath, optional sortBy (name or size)Entries with sizes; directories report their recursive total.
directory_treepath, optional excludePatternsA nested JSON tree of {name, type, children?} nodes.
move_filesource, destinationMoves or renames within the sandbox.
search_filespath, pattern, optional excludePatternsRecursive glob search over file names (**, *, ?).
get_file_infopathSize, created/modified/accessed times, type, and permissions.
list_allowed_directories—The roots currently in force.

Development

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network
npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Frequently asked questions

What is io.github.CloudCorpRecords/fileport?

Sandboxed file access: read, write, edit and search in allowed dirs.

How do I install io.github.CloudCorpRecords/fileport?

It runs on your machine. In Claude Code: claude mcp add fileport -- npx -y @reneturcios/fileport@0.1.0 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.CloudCorpRecords/fileport need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.CloudCorpRecords/fileport open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.CloudCorpRecords/fileport?

It is published by CloudCorpRecords. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.