convez.ai
MCP ServerBusca & PesquisaAvançado
ian-cowley

Glacier.Grep

ian-cowley/Glacier.Grep

Busca SIMD zero-allocation com MCP nativo para .NET 10

Ver no GitHub
BomPluginScore · de 0 a 100

Motor de busca de altíssimo desempenho para .NET 10, com aceleração SIMD, alocação zero e suporte nativo a MCP. Substitui ripgrep dentro do ecossistema Glacier, oferecendo varredura de diretórios lock-free, suporte a arquivos de ignore (.gitignore, .rgignore) e regex sem heap allocation.

Instalação

$npx convez-ai ian-cowley/Glacier.Grep

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
9
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 5 dias
Versão
v1.0.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Busca de código em bases grandes com máxima performance
  • Integração de busca em agentes AI via MCP
  • Processamento de logs e arquivos de texto com baixa latência

Veredito

Ferramenta niche de altíssima performance para cenários de busca críticos em .NET 10. Excelente integração MCP para agentes AI, mas requer .NET 10+ e conhecimento técnico sólido de C#.

README

A tradução para o português deste README ainda está na fila.

Glacier.Grep

NuGet Version NuGet Downloads

Glacier.Grep is a native, high-performance, zero-allocation C# search engine and index for .NET 10. Built to take on ripgrep within the Glacier ecosystem, it provides aggressive hardware acceleration (SIMD), concurrent work-stealing directory scanning, and built-in support for the Model Context Protocol (MCP).


Key Features

  • 🚀 SIMD-Accelerated Hot Path: Utilizes hardware-accelerated set searching via .NET 10 SearchValues<byte> and auto-vectorized scanning on raw UTF-8 bytes without string conversions.
  • 📂 Lock-Free Directory Enumeration: Implements custom FileSystemEnumerable checking which evaluates file metadata (hidden status, symlinks) and ignore matches entirely on the stack before materializing path strings.
  • ⚙️ Advanced Ignore File Support: Evaluates rules from .gitignore, .ignore, and .rgignore hierarchically, matching ripgrep's prioritized exclusion behavior.
  • ⚡ Hybrid I/O Dispatcher: Automatically routes files based on size (using zero-copy Memory-Mapped Files for >1MB and RandomAccess read into ArrayPool<byte> for <1MB).
  • 🔍 Zero-Allocation Regex Matching: Leverages .NET JIT-compiled regex engines with Regex.EnumerateMatches(ReadOnlySpan<char>) for zero heap allocation searches.
  • 🤖 MCP Server Support: Built-in support for the Model Context Protocol, allowing seamless integration with AI agents and tools.

Installation

To build and run Glacier.Grep, clone this repository and build using .NET 10 CLI:

dotnet build src/Glacier.Grep.Host/Glacier.Grep.Host.csproj -c Release

Quick Start (CLI Mode)

You can run Glacier.Grep directly from the command line:

# Basic literal search
dotnet run --project src/Glacier.Grep.Host/Glacier.Grep.Host.csproj "public class"

# Case-sensitive search with 2 lines of context in a specific directory
dotnet run --project src/Glacier.Grep.Host/Glacier.Grep.Host.csproj "public class" --dir "C:\src\myproject" --sensitive --context 2

# Regex search restricted to C# files
dotnet run --project src/Glacier.Grep.Host/Glacier.Grep.Host.csproj "void\s+\w+Async" --regex --globs "*.cs"

# Search hidden files, binary files, and invert the match (lines NOT containing "Oranges")
dotnet run --project src/Glacier.Grep.Host/Glacier.Grep.Host.csproj "Oranges" --hidden --text --invert

# Limit search depth to 2 directories
dotnet run --project src/Glacier.Grep.Host/Glacier.Grep.Host.csproj "target" --max-depth 2

MCP Server Setup

Glacier.Grep includes a built-in MCP (Model Context Protocol) server host, allowing you to use your search engine as a tool for AI agents (like Claude or Antigravity).

1. Build the Server

Build the host application in Release mode:

dotnet build src/Glacier.Grep.Host/Glacier.Grep.Host.csproj -c Release

2. Configure Your Client

Add the following entry to your mcp_config.json:

{
  "mcpServers": {
    "glacier-grep": {
      "command": "dotnet",
      "args": [
        "ABS_PATH_TO_REPO/src/Glacier.Grep.Host/bin/Release/net10.0/Glacier.Grep.Host.dll"
      ]
    }
  }
}

3. Available Tools

  • search_grep: Performs a high-performance search across files in a directory.
    • query (string, required): The search query (literal or regex).
    • path (string, optional): Base directory to search.
    • isRegex (boolean, optional): Treat query as regular expression.
    • caseSensitive (boolean, optional): Perform case-sensitive match.
    • contextLines (integer, optional): Lines of context to include around matches.
    • fileGlobs (array of strings, optional): Filter files (e.g. ["*.cs"]).
    • searchHidden (boolean, optional): Search hidden files and folders.
    • searchBinary (boolean, optional): Search binary files (do not skip).
    • invertMatch (boolean, optional): Invert the match (show lines that do NOT contain the query).
    • maxDepth (integer, optional): Maximum recursion depth for subdirectories.

Performance

Glacier.Grep is aggressively optimized for .NET 10 to saturate memory bandwidth, performing within ~1.2x of Ripgrep's raw Rust execution speed on typical developer workloads, and even outperforming it on case-sensitive paths.

Benchmark (Searching the entire Glacier/PolarsPlus workspace)

  • Target: 590 files, 257.83 MB
  • OS/Hardware: Windows (x64), modern multi-core CPU
EngineQueryExecution Time (Warmed)Performance Ratio
Ripgrep (Rust)"public class" (Sensitive)134.9 ms1.12x
Glacier.Grep (.NET 10)"public class" (Sensitive)120.4 ms1.00x (FASTER)
Ripgrep (Rust)"public class" (Insensitive)137.9 ms1.00x
Glacier.Grep (.NET 10)"public class" (Insensitive)210.4 ms1.52x (improved from 1.7x)
Ripgrep (Rust)"ThreadIndependentReaderWriterLock" (Insensitive)115.7 ms1.00x
Glacier.Grep (.NET 10)"ThreadIndependentReaderWriterLock" (Insensitive)142.3 ms1.23x (improved from 1.7x)

Architecture

  1. Directory Traverser: Zero-allocation metadata filtration. Prunes ignored folders (like .git, node_modules, bin/) and applies .gitignore, .ignore, and .rgignore rules.
  2. Hybrid I/O Dispatcher: Chooses the fastest reading technique depending on file size.
  3. Search Core: Evaluates the bytes using ReadOnlySpan<byte> and JIT vectorization.
  4. MCP Integration: Integrates the search capabilities over standard stdio JSON-RPC.

Credits

Developed by Ian Cowley and Antigravity (Google DeepMind).

License

This project is licensed under the MIT License - see the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados