Metadata-Version: 2.4
Name: rh-fastmcp-server-commons
Version: 0.3.2
Summary: Shared FastMCP scaffolding for Red Hat MCP servers.
License: Apache-2.0
License-File: LICENSE
Author: Red Hat Lightforge MCP
Author-email: lightforge-mcp-eng@redhat.com
Maintainer: Red Hat Lightforge MCP
Maintainer-email: lightforge-mcp-eng@redhat.com
Requires-Python: >=3.12,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: certifi (>=2024.0.0)
Requires-Dist: fastmcp (>=3.4.4,<4.0.0)
Requires-Dist: httpx (>=0.28.1,<0.29.0)
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc (>=1.20.0,<2.0.0)
Requires-Dist: opentelemetry-sdk (>=1.20.0,<2.0.0)
Requires-Dist: pydantic (>=2.0,<3.0)
Description-Content-Type: text/markdown

# rh-fastmcp-server-commons

Shared FastMCP scaffolding for Red Hat MCP servers: MCP Authorization spec compliant setup, correct scopes step-up handling and per-tool scopes restriction, tool pipeline, GraphQL operations, HTTP/TLS helpers, search client, and observability setup.

Developed by **Red Hat** as part of the **Lightforge** MCP initiative.

Source will be open-sourced later. The package is public on PyPI now, the VCS is not public yet.

## Install

```bash
pip install rh-fastmcp-server-commons
```

```python
import rh_fastmcp_server_commons
from rh_fastmcp_server_commons.auth import build_auth_provider, build_http_app
```

## Documentation

Library usage docs ship with the installed package under `rh_fastmcp_server_commons/docs/`:

- `getting-started.md` (server skeleton and how to run)
- `configuration.md`
- `authentication.md`
- `graphql.md`
- `http-client.md`
- `observability.md`
- `search.md`

## License

Apache-2.0. See the `LICENSE` file included in the distribution.

