Metadata-Version: 2.4
Name: mcs-driver-filesystem
Version: 0.2.2
Summary: Filesystem driver for the Model Context Standard.
Author-email: Danny Gerst <danny@dannygerst.de>
License-Expression: Apache-2.0
Project-URL: Homepage, https://www.modelcontextstandard.io
Project-URL: Source, https://github.com/modelcontextstandard/python-sdk
Keywords: mcs,modelcontextstandard,driver,filesystem
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcs-driver-core>=0.2.2
Dynamic: license-file

# mcs-driver-filesystem

Filesystem driver for the **Model Context Standard (MCS)**.

Provides `list_directory`, `read_file`, and `write_file` tools. The actual
I/O is delegated to a pluggable adapter, making the same driver work with
local disk, SMB shares, or any future backend (S3, SFTP, ...).

## Installation

```bash
pip install mcs-driver-filesystem
```

## Quick start

```python
from mcs.driver.filesystem import FilesystemToolDriver

# Local filesystem (default)
td = FilesystemToolDriver(adapter="localfs", base_dir="/data")

# SMB share
td = FilesystemToolDriver(adapter="smb", server="nas", share="docs",
                           username="user", password="pass")
```

## Adapter protocol

The driver defines a `FilesystemPort` typing protocol. Any object that
implements `list_dir`, `read_text`, `write_text`, `list_files`, `read_raw`,
and `exists` satisfies the contract -- no inheritance required.

## Links

- **Homepage:** <https://www.modelcontextstandard.io>
- **Source:** <https://github.com/modelcontextstandard/python-sdk>

## License

Apache-2.0
