Metadata-Version: 2.4
Name: mcs-driver-rest
Version: 0.2.2
Summary: REST/OpenAPI 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,rest,openapi,http
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
Requires-Dist: mcs-adapter-http>=0.2
Provides-Extra: inspector
Requires-Dist: mcs-inspector>=0.1; extra == "inspector"
Dynamic: license-file

# mcs-driver-rest

REST / OpenAPI driver for the **Model Context Standard (MCS)**.

Parses any OpenAPI 3.x specification and exposes every endpoint as a
structured tool that an LLM can call. Supports tag-based and path-based
filtering for large APIs (e.g. GitHub, Stripe).

## Installation

```bash
pip install mcs-driver-rest
```

## Quick start

```python
from mcs.driver.rest import RestDriver

driver = RestDriver(
    url="https://api.example.com/openapi.json",
    include_tags=["search"],
)
system_prompt = driver.get_driver_system_message()
```

## Features

- Automatic tool discovery from OpenAPI specs
- `include_tags` / `include_paths` filtering
- Tool name sanitisation for LLM compatibility
- Interactive inspector CLI: `python -m mcs.driver.rest.inspector <URL>`

## Links

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

## License

Apache-2.0
