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

Published packages

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

SDK	Path	Docs
Python	sdk/python	README
TypeScript	sdk/typescript	README
Go	sdk/go	README
C	sdk/c	README
Rust	src	README

Development

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

License

Apache-2.0 — see LICENSE.