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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_compressor-0.31.8.tar.gz.
File metadata
- Download URL: mcp_compressor-0.31.8.tar.gz
- Upload date:
- Size: 148.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe7a9ebae764bccddd8c471063fafca099404cb63284d4b67fcbacc26e4d3752
|
|
| MD5 |
ab125743173448d19edf96d44412cf30
|
|
| BLAKE2b-256 |
810dd7bd05dd06f5701cda1cd5d46b8f223d708fd2d82310a4eaa4858fa5691a
|
File details
Details for the file mcp_compressor-0.31.8-cp311-abi3-win_amd64.whl.
File metadata
- Download URL: mcp_compressor-0.31.8-cp311-abi3-win_amd64.whl
- Upload date:
- Size: 6.6 MB
- Tags: CPython 3.11+, Windows x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5632a3a6192efd5323eed2e2a9b0f94802111919a58f85650202f58a43cd2e69
|
|
| MD5 |
1dd4228766e4d74f727c3828a184263c
|
|
| BLAKE2b-256 |
d5a4d4dfb7ab1ca79187033aa5166b1b1f02628ef04134c8e29e53cf995d61d8
|
File details
Details for the file mcp_compressor-0.31.8-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: mcp_compressor-0.31.8-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 7.7 MB
- Tags: CPython 3.11+, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
26c0857362169e823490964d13338cc2b58c9ff2ffc9fc11712bf9adc3988f3e
|
|
| MD5 |
a1fdcc240701a55d5da467cb27863357
|
|
| BLAKE2b-256 |
fe4b2e94dbdc914fcec185e966465a96a96afb1deb8b540e212290f2897ba600
|
File details
Details for the file mcp_compressor-0.31.8-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: mcp_compressor-0.31.8-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 7.7 MB
- Tags: CPython 3.11+, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e75f56b43d70c2503d6d4e314e5a6f5b1b1e17934d66e905e2208bd5c6d919a8
|
|
| MD5 |
160eecc118a0881346ae8668919e301b
|
|
| BLAKE2b-256 |
97f181856608cf70b42797cd4607bb21b8849e4a4be269f5b83453f6ffb165ca
|
File details
Details for the file mcp_compressor-0.31.8-cp311-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: mcp_compressor-0.31.8-cp311-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 7.0 MB
- Tags: CPython 3.11+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7302c680a221104c0852213933a02faa2e34c9b2bb86270f00ff918c096ede8
|
|
| MD5 |
2d044934fe25abbda5ad2ebc13cedd23
|
|
| BLAKE2b-256 |
a053579d169601ca6c2fdb3ebe4c5c1e0f1e854f3280fbb915961b65a126c727
|
File details
Details for the file mcp_compressor-0.31.8-cp311-abi3-macosx_10_12_x86_64.whl.
File metadata
- Download URL: mcp_compressor-0.31.8-cp311-abi3-macosx_10_12_x86_64.whl
- Upload date:
- Size: 7.1 MB
- Tags: CPython 3.11+, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5165d16d5d46258b3802c8410ce637d8fa4ed7d23bd039304544c7b09947223a
|
|
| MD5 |
349dc0c8b5dd1897df7e19372251b59a
|
|
| BLAKE2b-256 |
47dfe136df39984697396d3c0dac244360092ca9f04ce52ceea782d1c797b465
|
