Base1000QianZiWenCodec

Base1000QianZiWenCodec is a text encoder/decoder that converts arbitrary text into a sequence of Thousand Character Classic characters and can decode it back to the original input. It provides a command-line tool, a Python extension module, and direct execution methods via UVX and pipx, making it easy to integrate into scripts or run locally. You can encode short or long texts, and the decoder will reconstruct the original string. The Python package also exposes a Python API for programmatic usage, so you can encode or decode within Python projects or notebooks. To run via MCP, you can connect to the project via UVX or set up a custom context as shown in the examples, enabling you to manage and deploy this tool within your workflow.

Prerequisites:

• Rust toolchain (cargo) for building the core library and CLI.
• Python (for the Python extension) and maturin to build the Python package.
• Optional: uvx and pipx for direct execution via UVX/pipx.

1. Install Rust and cargo

   • On macOS/Linux: install via rustup https://rustup.rs
   • On Windows: install Rust via rustup-init or the Rust installer

2. Build the project (default features)

   • cargo build --release

3. (Optional) Build with specific features

   • Enable CLI: cargo build --release --features clap
   • Enable Python extension: cargo build --release --features pyo3
   • Enable encoding/decoding: cargo build --release --features encode
   • Enable decoding: cargo build --release --features decode
   • Enable multiple features: cargo build --release --features "clap pyo3 encode decode"

4. Build the Python extension using maturin

   • maturin build --release

5. Install the Python package directly from Git (optional)

   • pip install "git+https://github.com/real-LiHua/Base1000QianZiWenCodec"

Tips:

• The MCP config uses UVX to fetch the repository and run the tool in a managed environment. If you prefer a local setup, you can clone the repo and install locally via cargo or maturin as described.
• The CLI entry point is base1000, which supports -e for encoding and -d for decoding. Example: base1000 -e "114514" and base1000 -d "夜裳移柰梧".
• The Python extension module exposes a base1000.encode(text) and base1000.decode(encoded) API for easy integration into Python projects.
• When using UVX, you can directly execute the tool from the Git URL to ensure you’re running the latest code with the mcp switch enabled.
• If you encounter encoding/decoding inconsistencies, ensure you’re using the same feature set (encode/decode) in both build and runtime configurations.