Context Crystallizer

Context Crystallizer

MCP server enabling AI agents and developers to crystallize large repos into searchable, AI-optimized contexts.

15
Stars
1
Forks
14
Releases

Overview

Context Crystallizer is an MCP-enabled AI Context Engineering tool that transforms massive repositories into crystallized, AI-consumable knowledge through systematic analysis and optimization. It scans the repository, automatically respecting .gitignore patterns, and skips common build directories (node_modules, dist, build, .git). It filters out binary files and very large files (>1MB). The process follows a simple three-step workflow: Initialize (prepare for crystallization), Crystallize (AI analyzes each file to extract meaningful knowledge), and Search (retrieve crystallized contexts). It exposes an MCP-based toolset (11 crystallization tools) for conversation-driven crystallization: guidance, initialization, file sequencing, storage, progress monitoring, search, bundling, dependency discovery, complexity filtering, quality validation, updates, and more. It also provides a CLI interface for developers to run guidance, init, progress, search, bundle, related, validate, update, and mcp commands. Crystallized contexts are persisted under .context-crystallizer/. The server supports Claude Desktop integration and can connect to MCP-compatible clients, offering a token-efficient, AI-optimized knowledge base to assist with large-scale code understanding.

Details

Owner
hubertciebiada
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

MCP Tool Suite for AI Agents

A comprehensive set of 11 crystallization MCP tools enabling conversation-driven analysis, guidance, processing, search, and knowledge storage.

Simple 3-step Crystallization Process

Initialize, Crystallize, and Search to transform a repository into a navigable crystallized knowledge base.

Respect .gitignore and Skip Large Files

Initialize automatically respects ignore patterns, skips common build dirs, binary files, and files larger than 1MB.

Token-efficient, AI-Optimized Contexts

Outputs are compressed into AI-friendly crystallized contexts with a documented 5:1 token compression ratio.

Searchable Crystallized Context Base

Crystallized contexts are designed for fast, targeted retrieval by functionality or pattern.

Persistent Storage of Crystallized Contexts

Stored under .context-crystallizer/ to preserve crystallized knowledge between runs.

MCP Protocol Compatibility

Implements standard MCP tool discovery and execution so any MCP-compatible client can interact with the server.

Claude Desktop & Developer Integrations

Supports Claude Desktop integration and provides CLI tooling for developers to control crystallization workflows.

Audience

AI agentsInteract with Context Crystallizer via MCP for conversation-driven crystallization and knowledge search.
DevelopersUse the CLI to initialize, run, monitor, and update crystallization; integrate with Claude Desktop and MCP-compatible clients.

Tags

crystallizationAI context engineeringMCP serverknowledge basesearchable contexttoken-efficientLLM-optimizedClaude integrationCLIAI agentsrepository analysis