mcp-compressor Python SDK
Python SDK and CLI wrapper for mcp-compressor.
The public Python import is mcp_compressor:
from mcp_compressor import CompressorClient
Quick start
The primary SDK object is CompressorClient. It starts a local session and returns a CompressorProxy; no mcp-compressor stdio subprocess is required.
from mcp_compressor import CompressorClient
servers = {
"alpha": {
"command": "python",
"args": ["alpha_server.py"],
},
"atlassian": {
"url": "https://mcp.atlassian.com/v1/mcp",
},
}
with CompressorClient(
servers=servers,
mode="compressed",
compression_level="medium",
include_tools=["getConfluencePage", "updateConfluencePage"],
toonify=True,
) as proxy:
print([tool.name for tool in proxy.tools])
result = proxy.invoke(
"getAccessibleAtlassianResources",
{},
server="atlassian",
)
print(result)
Modes
CompressorClient accepts these modes:
compressed— expose compressed wrapper tools such as<server>_get_tool_schemaand<server>_invoke_tool.cli— expose CLI/help tools for generated shell command usage.bash— expose Just Bash command integration for command-oriented agents.
Generated Python and TypeScript clients are produced with proxy.write_client(...) rather than by selecting a long-lived session mode.
Just Bash metadata
Just Bash mode lets language hosts register backend MCP tools as shell-style commands:
from mcp_compressor import CompressorClient, create_just_bash_commands
with CompressorClient(servers=servers, mode="bash") as proxy:
commands = {cmd.command_name: cmd for cmd in create_just_bash_commands(proxy)}
print(commands["atlassian_get-accessible-atlassian-resources"]([]))
Duplicate backend command names are prefixed with the provider name, for example alpha_echo and beta_echo.
Generated clients
A connected proxy can write shell, Python, or TypeScript clients that call the live proxy:
with CompressorClient(servers=servers, compression_level="max") as proxy:
proxy.write_client("cli", "./bin", name="atlassian")
proxy.write_client("python", "./generated-py", name="atlassian")
proxy.write_client("typescript", "./generated-ts", name="atlassian")
Packaging smoke test
Build a local wheel and verify it imports from a clean virtualenv:
uvx maturin build --release --out dist
python -m venv /tmp/mcp-compressor-wheel-test
/tmp/mcp-compressor-wheel-test/bin/python -m pip install "$PWD"/dist/*.whl
cd /tmp
/tmp/mcp-compressor-wheel-test/bin/python -c "from mcp_compressor import CompressorClient, ToolSpec"
CI runs the same kind of wheel smoke test before uploading the built wheel as an artifact.
Advanced helpers
Low-level helpers such as compress_tool_listing, parse_tool_argv, and ToolSpec remain available for tests and advanced integrations, but the primary SDK entry point is CompressorClient.
1 maintainer
Metadata
1 maintainer
Release files for mcp-compressor 0.33.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mcp_compressor-0.33.1.tar.gz | 172.3 kB | Without provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| mcp_compressor-0.33.1-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details |
| mcp_compressor-0.33.1-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| mcp_compressor-0.33.1-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| mcp_compressor-0.33.1-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details |
| mcp_compressor-0.33.1-cp311-abi3-macosx_10_12_x86_64.whl | CPython 3.11 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 42.5 MB
Release files / mcp_compressor-0.33.1.tar.gz
| Download URL | mcp_compressor-0.33.1.tar.gz |
|---|---|
| Size | 172.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a5bae84cbb5cb53bc4589b434b8397f657926faa7e7d35fed9f28ddf0bb24e8
|
|
BLAKE2b-256 checksum How to use checksums |
fa31d04c576ba4405e3b462e8beae4cca14aa9e47e08f6e84e691561f966190d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mcp_compressor-0.33.1-cp311-abi3-win_amd64.whl
| Download URL | mcp_compressor-0.33.1-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
209b2e5a7c255569ed02f3c9902c162e993e8cbfcec66e1a531ea7269fb83c1e
|
|
BLAKE2b-256 checksum How to use checksums |
46ee81fbede1a8137d98b03b653430ae35b6874b1c6a47d54c0e2e4e413b24cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mcp_compressor-0.33.1-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mcp_compressor-0.33.1-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 8.9 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
43b89371b800ccad2055c9e0cee599c9f790bd8aa1efa14d3b49aee3ab8da06c
|
|
BLAKE2b-256 checksum How to use checksums |
87da37fd18888d2b335578f3f5ff0eff679aec6f9008235929c35014f19289cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mcp_compressor-0.33.1-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | mcp_compressor-0.33.1-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 9.1 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
748a997172a245a99a029d9d714050637bcf5cd820be47ce3f902b2b78159d9a
|
|
BLAKE2b-256 checksum How to use checksums |
c934fcff65f3ae0b9fb01f04214219d72ff3dde8f7535393c486acca2fab18cc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mcp_compressor-0.33.1-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | mcp_compressor-0.33.1-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 8.2 MB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
34676abc8144b9a4e8ba33726751685ca8a343e06d6f06f79d7b81f9661d7f16
|
|
BLAKE2b-256 checksum How to use checksums |
b00404b3a26d584ce9c1701ddeb03cb317c0c7c01353d93007f1f2aa4d702e66
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mcp_compressor-0.33.1-cp311-abi3-macosx_10_12_x86_64.whl
| Download URL | mcp_compressor-0.33.1-cp311-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 8.3 MB |
| Tags | CPython 3.11 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
c409083ffbcde4800b7d1562b2adb3180cf0bb2a5fcd523fa910f947bc13411c
|
|
BLAKE2b-256 checksum How to use checksums |
cd3cb96966069fe2cb7cb4502914d48d4cc8ac07729975f1a258b818cd3e5581
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mcp-compressor 0.33.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
