context-squeeze MCP server
Commit 11. Nov. 2026Versorgt AI Agents mit einer kompakten Symbol-Map eines Codebases, um Dateien zu navigieren, ohne übermäßig viel Context Window Platz zu verbrauchen.
Auch bekannt als Ankara-Software/context-squeeze
- Stars
- 1
- Tools
- 4
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
Was ist context-squeeze MCP?
context-squeeze ist ein MCP server. Versorgt AI Agents mit einer kompakten Symbol-Map eines Codebases, um Dateien zu navigieren, ohne übermäßig viel Context Window Platz zu verbrauchen. Er stellt 4 Tools bereit, etwa path, file_path, symbol_name.
Zusammenfassung generiert aus dem README des Projekts
Über context-squeeze MCP server
Die Hauptfunktion von context-squeeze ist das Navigieren in großen Codebases, ohne das Context Window deines AI Models zu erschöpfen. Dieser auf Rust basierende MCP server ermöglicht es Agents wie Claude Desktop, Cursor oder Cline, Repositories zu explorieren, indem sie zuerst eine kompakte Symbol-Map mit Signaturen für Klassen, Structs, Interfaces und Funktionen anfordern. Sobald der Agent die relevante Logik identifiziert hat, kann er den vollständigen Body eines spezifischen Symbols abrufen, anstatt ganze Dateien zu lesen.
Entwickler nutzen dieses Tool, indem sie es über die Rust Toolchain aus dem Source installieren und als stdio server in ihren Client-Einstellungen konfigurieren. Es unterstützt Python, TypeScript, JavaScript, Rust und Go Dateien. Der Server bietet drei spezifische Tools: get_repo_map zum Erstellen einer Workspace-Übersicht, get_code_item zum Abrufen des Bodys spezifischer Symbole und search_code für case-insensitive Substring-Suchen über Symbolnamen und Signaturen hinweg. Da die Symbol-Extraktion auf Regular Expressions basiert, ist das Tool sehr leichtgewichtig, kann aber bestimmte interne Methoden in spezifischen Sprachen übersehen.
Was du damit machen kannst
- 1Workspace-Übersicht generierenLass die KI eine kompakte Map aller Klassen und Funktionen in einem Verzeichnis erstellen, um die Projektstruktur zu verstehen.
- 2Spezifische Funktionslogik abrufenFordere die vollständige Implementierung einer einzelnen Funktion oder eines Structs an, sobald deren Signatur identifiziert wurde.
- 3Nach spezifischen Symbolen suchenFinde heraus, wo ein bestimmtes Interface oder eine Funktion definiert ist, indem du nach einem Substring in der gesamten Codebase suchst.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
context-squeeze MCP tools 4
Erkannt aus dem READMEpathfile_pathsymbol_namequery
| path | — | |
| file_path | — | |
| symbol_name | — | |
| query | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarankara-software/context-squeeze is public and reachablegithub.com/ankara-software/context-squeeze ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-11github.com/ankara-software/context-squeeze ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenMaintained by Ankara Yazılım | Project page
Status: beta. It builds, the 5 parser unit tests pass and the three MCP tools were called over stdio against sample Python, TypeScript and Go files. Symbol extraction uses regular expressions, not a real parser, so it misses some symbols (see Limitations). No prebuilt binaries or npm package have been published yet; install from source.
Context-Squeeze
Context-Squeeze is a small Model Context Protocol (MCP) server written in Rust that helps AI agents (such as Claude Desktop, Cursor, Cline or local LLM clients) navigate a codebase. Instead of reading whole files, the agent first asks for a compact symbol map (signatures of classes, structs, interfaces and functions) and then fetches the body of only the symbol it needs. This keeps less source text in the model's context window.
Türkçe
Context-Squeeze, yapay zeka ajanlarının (Claude Desktop, Cursor, Cline vb.) büyük kod tabanlarında gezinmesine yardım eden, Rust ile yazılmış küçük bir Model Context Protocol (MCP) sunucusudur. Ajan, dosyaların tamamını okumak yerine önce sınıf, struct, arayüz ve fonksiyon imzalarından oluşan kısa bir sembol haritası ister, sonra yalnızca ihtiyaç duyduğu sembolün gövdesini getirir. Böylece modelin bağlam penceresinde daha az kaynak kodu tutulur. Python, TypeScript/JavaScript, Rust ve Go dosyalarını destekler; sembolleri düzenli ifadelerle çıkarır, bu yüzden bazı semboller (örneğin Python ve TypeScript sınıf metotları) haritada görünmez. Proje beta aşamasındadır; hazır ikili dosya ve npm paketi henüz yayımlanmamıştır, kaynaktan kurulur.
Installation
Build from source (Rust toolchain required):
cargo install --git https://github.com/Ankara-Software/context-squeeze
This installs a context-squeeze binary that speaks MCP over stdin and stdout. Or build it manually:
git clone https://github.com/Ankara-Software/context-squeeze.git
cd context-squeeze
cargo build --release
# The compiled binary will be in target/release/context-squeeze
The package.json and bin/cli.js files describe an npm wrapper (context-squeeze-mcp) that downloads a release binary. That package is not on the npm registry and the v0.1.0 release has no binary assets, so npx -y context-squeeze-mcp does not work yet.
Client Setup
Claude Desktop
Add the following to your claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS). Use the full path of the binary if it is not on your PATH:
{
"mcpServers": {
"context-squeeze": {
"command": "context-squeeze"
}
}
}
Cursor
- Open Cursor Settings -> Features -> MCP.
- Click + Add New MCP Server.
- Set:
- Name:
context-squeeze - Type:
stdio - Command:
context-squeeze
- Name:
- Save.
get_code_item and search_code read files relative to the working directory of the server process, so start the server from the project you want to explore.
Exposed MCP Tools
1. get_repo_map
Walks the workspace and builds a compact outline. It respects .gitignore rules and skips hidden files.
- Returns: for each file with symbols, the file path and the signature line of each class, struct, interface, trait, enum and function found. Bodies are omitted.
- Arguments:
path: (Optional) Directory to scan. Defaults to the current directory.
2. get_code_item
Returns the full body of one symbol in one file.
- Arguments:
file_path: (Required) Path to the source file, relative to the working directory.symbol_name: (Required) Name of the class, struct, function or interface.
3. search_code
Case-insensitive substring search over symbol names and signatures across the workspace.
- Arguments:
query: (Required) Text to look for.
- Returns: file, symbol, kind, signature and line range for each match.
Supported languages
Files with these extensions are indexed: py, ts, tsx, js, jsx, rs, go.
Limitations
- Symbols are found with regular expressions. Methods inside Python and TypeScript classes are not listed (the class line is); Rust
implfunctions and Go methods are. - Only the extensions listed above are indexed.
- The server does not restrict paths:
get_code_itemjoins the given path to the working directory. Run it only for clients and projects you trust.
Measured Example
One run of get_repo_map on this repository's own source plus three small sample files (28,853 bytes of source in total) returned a map of 1,968 bytes. This is a byte count from a single run, not a token count, and the ratio depends heavily on the codebase.
Development
cargo build
cargo test
See CONTRIBUTING.md, SECURITY.md and CODE_OF_CONDUCT.md.
License
MIT. Copyright (c) 2026 Anılcan Kara and Ankara Yazılım contributors.
context-squeeze MCP Fragen
Welche Tools bietet context-squeeze MCP?
Er stellt 4 Tools bereit, darunter path, file_path, symbol_name, query.
Welche Programmiersprachen werden unterstützt?
Der Server indiziert Dateien mit den Endungen py, ts, tsx, js, jsx, rs und go.
Wie funktioniert die Symbol-Extraktion und was sind ihre Grenzen?
Es werden Regular Expressions anstelle eines echten Parsers verwendet, was bedeutet, dass bestimmte Symbole wie Methoden innerhalb von Python- und TypeScript-Klassen eventuell nicht erfasst werden.