Chunk Your Tools

Decompose and recompose MCP tool definition JSON schemas. Split large tool inputSchema trees into addressable chunks (tools, optional properties, enums), then rebuild pruned tool definitions from survivor lists.

This library is extracted from clear-your-tools and contains only decomposition/recomposition.

What it does

1. Chunk/Decompose — parse MCP tool definition JSON into addressable chunks (tools, optional properties, enums).
2. Cache — write metadata.json and per-chunk files under a catalog directory.
3. Recompose — rebuild pruned tool definitions from survivor lists.

Packages C/Go/Rust/TypeScript/Python

chunk-your-tools (crates.io)

Rust library and CLI

chunk-your-tools (PyPI)

Python SDK (import chunk_your_tools)

chunk-your-tools (npm)

TypeScript SDK

libchunk_your_tools (Release)

C library via CMake / build-c-lib.sh

sdk/go (pkg.go.dev)

Go SDK via cgo (import chunkyourtools)

Quick start

Install the CLI:

cargo install chunk-your-tools

Or build locally: cargo build -p chunk-your-tools --release.

Library installs:

cargo add chunk-your-tools
pip install chunk-your-tools
npm install chunk-your-tools

Try the bundled walkthrough — decompose a sample tool catalog, then recompose pruned variants:

./examples/decompose.sh
export PATH="$PWD/target/release:$PATH"
./examples/recompose.sh

See examples/README.md for survivor formats, output paths, and CLI flags.

SDKs

Development

See DEV.md and run ./scripts/local-dev.sh all for the full monorepo check.

License

Apache-2.0 — see LICENSE.