code-compressor MCP Server
Tối ưu đến 65% Token cho Codex & LLM Context Window

Nén Code Thông Minh.
Giữ Nguyên Cấu Trúc Độc Lập

Giải pháp giảm dung lượng mã nguồn tối ưu cho Codex AI. Giữ vững các signature hàm, class, import quan trọng và đảm bảo 100% không lỗi cú pháp thông qua Tree-sitter & Headroom.

Thử Nghiệm Trực Tiếp Hướng Dẫn Cài Đặt CLI & MCP
35% - 65%
Tiết kiệm Token
100%
An Toàn Cú Pháp
12+
Ngôn Ngữ Hỗ Trợ
MCP
Tích Hợp Khép Kín
Live Demo Simulator

Trải Nghiệm Thuật Toán Nén Code

Chọn mẫu:
0.35

Mục tiêu giữ lại % token so với file gốc.

5 dòng

Số dòng tối đa được giữ lại trong mỗi thân hàm.

`--plain` loại bỏ wrapper JSON để lấy mã trực tiếp.

src/compressor_demo.py
Gốc: 420 tokens 
# ... code source ...
COMPRESSED output.json
Còn lại: 168 tokens
Tiết kiệm: 60.0%
compressionRatio: 0.40 
# ... compressed code ...
Tại sao nên chọn MCP code-compressor?

Tính Năng Nổi Bật Dành Cho AI Engineers

Đảm Bảo An Toàn Cú Pháp 100%

Sử dụng parser AST Tree-sitter để phân tích lại mã output sau khi nén. Nếu phát hiện bất kỳ lỗi cú pháp nào hoặc tỷ lệ tiết kiệm < 5%, CLI sẽ tự động rollback trả về file gốc.

Tích Hợp MCP Tự Động Với Codex

Cung cấp managed block cho `~/.codex/config.toml`. Codex tự khởi động MCP server, quét cây thư mục dự án và đọc file nén mà không cần cài đặt rườm rà.

Bảo Mật Nhiều Lớp & Raw Access

MCP chỉ đọc trong Allowlist `allowed-files.json`. Khi AI thực sự cần xem file gốc, nó phải gọi `request_raw_file_access` tạo quyền dùng một lần (TTL 120 giây).

Kiến Trúc Luồng Dữ Liệu

Cơ Chế Phân Cấp Đọc Code Trong MCP

BƯỚC 1

Mở Dự Án trong Codex

Codex khởi động MCP, đọc `allowed-files.json` manifest và đăng ký ranh giới file cho phép.

Tool: list_code_compressor_projects
BƯỚC 2 (ƯU TIÊN 1)

Code Compressor

Nén giữ lại signature, import và class structure. Tiết kiệm ~50% token.

Tool: read_project_file
BƯỚC 3 (FALLBACK 1)

Universal Ctags Outline

Nếu file không hỗ trợ nén trực tiếp, tạo đề cương danh sách class, hàm và symbol chính.

Fallback: Ctags outline generator
BƯỚC 4 (FALLBACK 2)

Nội Dung Gốc (Raw)

Khi cần xem toàn bộ thân hàm triển khai, xin cấp quyền ngắn hạn 120s qua token.

Tool: request_raw_file_access
Đa Ngôn Ngữ

Ngôn Ngữ Hỗ Trợ Tận Gốc

Hệ thống phân tách luồng xử lý tối ưu dựa trên parser cho từng nhóm ngôn ngữ.

Headroom CodeAwareCompressor

Phân tích chuyên sâu cho các ngôn ngữ hệ thống & OOP
Python (.py) Go (.go) Rust (.rs) Java (.java) C / C++ (.c, .cpp, .h) C# (.cs)

Tree-sitter Language Pack

Không cần Node.js hay Babel, chạy thuần Python binding
JavaScript (.js, .jsx, .mjs) TypeScript (.ts, .tsx, .mts)

💡 Hỗ trợ bảo lưu comment thông minh: Tự động giữ nguyên các JSDoc tag quan trọng, License header, TypeScript Directives, Linter directives & Bundler hints.

Bắt Đầu Sử Dụng

Cài Đặt & Chạy Nhanh

Dành cho người muốn thử nhanh CLI không cần MCP

Tạo virtual environment riêng để tránh xung đột thư viện Python hệ thống:

# Tạo venv & cài đặt dependency
python3 -m venv .venv-cli
.venv-cli/bin/python -m pip install --upgrade pip
.venv-cli/bin/python -m pip install "tree-sitter==0.25.2" "tree-sitter-language-pack" "headroom-ai[code]"
# Chạy nén file mã nguồn
.venv-cli/bin/python src/code_compressor_cli.py ./src/code_compressor_cli.py --plain