English Français العربية

io.github.CloudCorpRecords/fileport

Registre officiel Recherche et web

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @reneturcios/fileport
Claude Code 
claude mcp add fileport -- npx -y @reneturcios/fileport@0.1.0 mcp
Configuration JSON (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
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "fileport": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/fileport:0.1.0",
                "mcp"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que io.github.CloudCorpRecords/fileport ?

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

Comment installer io.github.CloudCorpRecords/fileport ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add fileport -- npx -y @reneturcios/fileport@0.1.0 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.CloudCorpRecords/fileport ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.CloudCorpRecords/fileport est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.CloudCorpRecords/fileport ?

Il est publié par CloudCorpRecords. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.