Repository navigation
ServerFS v0.20.0
ServerFS v0.20.0 — Protocol & Distribution Maturity
This release strengthens MCP protocol compatibility and makes the existing Linux OCI image ready for Registry metadata and validation workflows.
MCP protocol compatibility
- Supports both the
2025-11-25session lifecycle and2026-07-28per-request behavior on the same stateful Streamable HTTP app. Existing clients retain session behavior; modern requests do not depend on a session. - Adds a CI gate using the official MCP Conformance suite pinned to an immutable source revision. Both requirement sets run separately; the gate covers reviewed applicable scenarios alongside real-wire regression tests.
- Keeps stdio, API Key HTTP, and OAuth HTTP boundaries independently tested. HTTP authentication does not apply to stdio.
Distribution metadata
- Adds a schema-validated
server.jsonand matching OCI identity/version metadata for the Linux image, with offline CI checks. - Metadata is ready for Registry workflows; the image has not been published to the MCP Registry. Registry-based installation and launch remain unverified. Existing direct distribution routes do not depend on Registry availability.
Compatibility, security, and scope
Linux container, Windows native, and macOS native workflows passed on the accepted release candidate. Linux OCI manifests cover amd64 and arm64; native Windows remains stdio, and macOS support remains Apple silicon, native arm64, macOS 27.
The release preserves workdir confinement, filesystem race protections, explicit authorization, HTTP Host/Origin and DNS-rebinding protections, and the existing provider permission boundaries. It adds no general shell execution, new endpoint, authentication provider, MCP Tasks support, or ACP v2 support.
Upgrade from v0.19.0
No data migration is planned. Existing deployments can retain their configuration and distribution route. Streamable HTTP continues to support the legacy session lifecycle while also accepting modern per-request behavior.
Release artifacts
Linux OCI image for amd64 and arm64; Windows native, ServerFS product, and Agent Bridge wheel artifacts; and the portable Agent Plugin ZIP. Windows wheel installation and checksum details are provided in the managed section below.
Windows installation assets (Python >= 3.12; no Rust/MSVC/Docker required)
The three release wheels install into two isolated environments, matching the
frozen ServerFS/Agent-Bridge process boundary (the supervisor selects the Bridge
interpreter through SERVERFS_BRIDGE_PYTHON; the packages never share one dependency
graph):
| file | installs into | sha256 |
|---|---|---|
| serverfs_mcp-0.20.0-py3-none-any.whl | ServerFS env | 391f6b562b5be001967ffc2037723a6d902e5b1a6017bc0e0f323576aa11bebc |
| serverfs_windows_native-0.20.0-cp312-abi3-win_amd64.whl | ServerFS env | 620d3cd2029a7591ff6116e2b0eacbeb70768dc3129298c1fca1faebf811b45d |
| serverfs_agent_bridge-0.20.0-py3-none-any.whl | Agent Bridge env | 4416ec6b61a5fd76d80ea24929ab53fdaa08b0c5558a380e7dbb818f8c0d9e68 |
ServerFS environment (product + native kernel):
uv venv --python 3.12 .venv-serverfs
uv pip install --python .venv-serverfs/Scripts/python.exe https://github.com/NTLx/ServerFS_MCP/releases/download/v0.20.0/serverfs_mcp-0.20.0-py3-none-any.whl https://github.com/NTLx/ServerFS_MCP/releases/download/v0.20.0/serverfs_windows_native-0.20.0-cp312-abi3-win_amd64.whl
Agent Bridge environment (Bridge + provider SDKs; it must NOT contain the product):
uv venv --python 3.12 .venv-bridge
uv pip install --python .venv-bridge/Scripts/python.exe https://github.com/NTLx/ServerFS_MCP/releases/download/v0.20.0/serverfs_agent_bridge-0.20.0-py3-none-any.whl
Point the ServerFS supervisor at the Bridge interpreter (set this in the environment
that starts serverfs supervisor; it is not a provider setting and does not belong in
[agent] config):
$env:SERVERFS_BRIDGE_PYTHON = "<path>\.venv-bridge\Scripts\python.exe"
Verified native-wheel storage alternative:
serverfs bootstrap native-wheel --url "https://github.com/NTLx/ServerFS_MCP/releases/download/v0.20.0/serverfs_windows_native-0.20.0-cp312-abi3-win_amd64.whl" --sha256 620d3cd2029a7591ff6116e2b0eacbeb70768dc3129298c1fca1faebf811b45d