Skip to main content
Glama
omni-fs-mcp

omni-fs-mcp

by vaayne

Omni-FS MCP Server

An MCP server that provides unified access to multiple file systems simultaneously through OpenDAL.

Installation

pip install omni-fs-mcp

Related MCP server: MinIO Model-Context Protocol (MCP) Server

Quick Start

Single Backend

# Local filesystem
omni-fs-mcp "fs://"

# S3
omni-fs-mcp --transport http "s3://bucket?region=us-east-1&access_key_id=xxx&secret_access_key=yyy"

# WebDAV
omni-fs-mcp "webdav://server.com/path?username=user&password=pass"

# Memory (testing)
omni-fs-mcp "memory://"

Multi-Backend with Config File

Create backends.json:

{
  "backends": [
    {
      "name": "local",
      "url": "fs://",
      "description": "Local filesystem",
      "default": true
    },
    {
      "name": "s3-prod",
      "url": "s3://bucket?region=us-east-1&access_key_id=...",
      "description": "Production S3"
    }
  ]
}

Run with config:

# Stdio (default)
omni-fs-mcp backends.json

# HTTP
omni-fs-mcp --transport http --config backends.json --port 8080

Usage

Command Options

omni-fs-mcp [OPTIONS] [URL_OR_CONFIG]

Options:
  --config FILE         JSON configuration file
  --transport TYPE      stdio (default) or http
  --port PORT          HTTP port (default: 8000)
  --host HOST          HTTP host (default: localhost)

Available Tools

File Operations:

  • list_files(path, backend=None) - List files and directories

  • read_file(path, backend=None) - Read file contents

  • write_file(path, content, backend=None) - Write to file

  • copy_file(src, dst, src_backend=None, dst_backend=None) - Copy files

  • rename_file(src, dst, backend=None) - Rename/move files

  • create_dir(path, backend=None) - Create directory

  • stat_file(path, backend=None) - Get file metadata

Backend Management:

  • register_backend(name, url, ...) - Add new backend

  • list_backends() - Show all backends

  • set_default_backend(name) - Set default backend

  • remove_backend(name) - Remove backend

  • check_backend_health(backend=None) - Check connectivity

Supported Backends

Type

URL Example

Local

fs://

S3

s3://bucket?region=us-east-1&access_key_id=...

WebDAV

webdav://server.com/path?username=user&password=pass

Memory

memory://

FTP

ftp://server.com?username=user&password=pass

HTTP

https://api.example.com

Examples

Cross-Backend Copy

# Backup to S3
copy_file("/local/file.txt", "/backup/file.txt",
          src_backend="local", dst_backend="s3-backup")

Runtime Backend Management

# Add temporary backend
register_backend("temp", "memory://", description="Temp storage")

# Use it
write_file("/test.txt", "content", backend="temp")

Development

git clone <repo>
cd omni-fs-mcp
uv sync

# Run locally
uv run omni-fs-mcp "memory://"

License

MIT

Available Tools

13 tools
check_backend_healthB
Check the health status of backends by attempting basic operations.

Args:
    backend: Specific backend to check (checks all if not specified)

Returns:
    Dictionary mapping backend names to their health status (True/False)

Inputs: backend. Returns: object

copy_fileB
Copy a file between backends or within the same backend.

Args:
    src: Source file path
    dst: Destination file path
    src_backend: Source backend name (uses default if not specified)
    dst_backend: Destination backend name (uses default if not specified)

Returns:
    Success message

Inputs: src (required), dst (required), src_backend, dst_backend. Returns: result

create_dirB
Create a directory on the specified backend.

Args:
    path: Directory path to create
    backend: Backend name to use (uses default backend if not specified)

Returns:
    Success message

Inputs: path (required), backend. Returns: result

get_backend_statsA
Get statistics and information about the backend manager.

Returns:
    Dictionary with total backends, default backend, healthy backends count, etc.

Inputs: no named parameters. Returns: object

list_backendsA
List all registered backends with their configurations and status.

Returns:
    List of backend information including name, URL, description,
    readonly status, default status, and health status

Inputs: no named parameters. Returns: result

list_filesB
List files and directories in the specified path.

Args:
    path: The directory path to list (default: "/")
    backend: Backend name to use (uses default backend if not specified)

Returns:
    List of entries with their metadata

Inputs: path, backend. Returns: result

read_fileC
Read file contents from the specified backend.

Args:
    path: File path to read
    backend: Backend name to use (uses default backend if not specified)

Returns:
    File contents as string

Inputs: path (required), backend. Returns: result

register_backendA
Register a new backend with the given configuration.

Args:
    name: Unique identifier for the backend (alphanumeric, hyphens, underscores only)
    url: Backend connection URL (e.g., "fs:///", "s3://bucket", "memory:///")
    description: Human-readable description of the backend
    readonly: Whether this backend should be treated as read-only
    timeout: Connection timeout in seconds
    retry_attempts: Number of retry attempts for failed operations
    set_as_default: Whether to set this as the default backend
    validate_connection: Whether to validate the connection during registration

Returns:
    Success or failure message

Inputs: name (required), url (required), description, readonly, +4 more. Returns: result

remove_backendA
Remove a backend from the manager.

Args:
    name: Name of the backend to remove
    force: Force removal even if it's the default backend

Returns:
    Success message

Inputs: name (required), force. Returns: result

rename_fileB
Rename or move a file within a backend.

Args:
    src: Source file path
    dst: Destination file path
    backend: Backend name to use (uses default backend if not specified)

Returns:
    Success message

Inputs: src (required), dst (required), backend. Returns: result

set_default_backendB
Set the default backend for operations when no backend is specified.

Args:
    name: Name of the backend to set as default

Returns:
    Success message

Inputs: name (required). Returns: result

stat_fileA
Get metadata/statistics for a file or directory.

Args:
    path: Path to get statistics for
    backend: Backend name to use (uses default backend if not specified)

Returns:
    File metadata object

Inputs: path (required), backend.

write_fileA
Write content to a file on the specified backend.

Args:
    path: File path to write to
    content: Content to write to the file
    backend: Backend name to use (uses default backend if not specified)

Returns:
    Success message

Inputs: path (required), content (required), backend. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a distinct operation: file reading, writing, copying, renaming, listing, directory creation, and backend management. No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent snake_case verb_noun pattern (e.g., write_file, list_backends), making them predictable and easy to understand.

    Tool Count5/5

    With 13 tools, the server covers both file operations and backend management comprehensively without being bloated.

    Completeness3/5

    The file operations cover most CRUD but are missing a delete file tool, which is a significant gap for a file system server. Backend management seems complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides a standardized way to interact with MinIO object storage, allowing access to text files, binary files, and bucket contents while supporting operations like listing buckets/objects, retrieving objects, and uploading files.
      6
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides unified access to multiple cloud object storage services (Huawei OBS, Alibaba OSS, AWS S3, MinIO) enabling AI assistants to list, search, retrieve, and manage unstructured data across different storage providers.
      -
    • F
      license
      A
      quality
      Not graded
      maintenance
      Enables unified access to both structured databases (PostgreSQL, MySQL, SQLite, etc.) and unstructured object storage (AWS S3, Alibaba OSS, Huawei OBS, etc.) through a single interface.
      7
      -