MCP-Grep

Una implementación de servidor grep que expone la funcionalidad grep a través del Protocolo de contexto de modelo (MCP).

Instalación

pip install mcp-grep

Related MCP server: cve-search_mcp

Uso

MCP-Grep se ejecuta como un servidor que puede ser utilizado por clientes compatibles con MCP:

# Start the MCP-Grep server
mcp-grep-server

# Or use the MCP Inspector for interactive debugging and testing
mcp-grep-inspector

El servidor expone la siguiente funcionalidad MCP:

Recurso: grep://info - Devuelve información sobre el binario grep del sistema
Herramienta: grep - Busca patrones en archivos utilizando el binario grep del sistema

Características

Información sobre el binario grep del sistema (ruta, versión, funciones compatibles)
Buscar patrones en archivos usando expresiones regulares
Compatibilidad con opciones comunes de grep:
- Coincidencia sin distinción entre mayúsculas y minúsculas
- Líneas de contexto (antes y después de los partidos)
- Número máximo de coincidencias
- Coincidencia de cadenas fijas (no expresiones regulares)
- Búsqueda recursiva de directorios
Comprensión de indicaciones en lenguaje natural para un uso más sencillo con LLM
Depuración y pruebas interactivas a través de MCP Inspector

Ejemplo de uso de la API

Usando el cliente Python de MCP:

from mcp.client import MCPClient

# Connect to the MCP-Grep server
client = MCPClient()

# Get information about the grep binary
grep_info = client.get_resource("grep://info")
print(grep_info)

# Search for a pattern in files
result = client.use_tool("grep", {
    "pattern": "search_pattern",
    "paths": ["file.txt", "directory/"],
    "ignore_case": True,
    "recursive": True
})
print(result)

Indicaciones en lenguaje natural

MCP-Grep comprende indicaciones en lenguaje natural, lo que facilita su uso con LLM. Ejemplos:

# Basic search
Search for 'error' in log.txt

# Case-insensitive search
Find all instances of 'WARNING' regardless of case in system.log

# With context lines
Search for 'exception' in error.log and show 3 lines before and after each match

# Recursive search
Find all occurrences of 'deprecated' in the src directory and its subdirectories

# Fixed string search (non-regex)
Search for the exact string '.*' in config.js

# Limited results
Show me just the first 5 occurrences of 'TODO' in the project files

# Multiple options
Find 'password' case-insensitively in all .php files, show 2 lines of context, and limit to 10 results

Integración de MCP Inspector

MCP-Grep incluye una integración de MCP Inspector para depuración y pruebas interactivas:

# Start the MCP Inspector with MCP-Grep
mcp-grep-inspector

Esto abre una interfaz de usuario basada en web donde puedes:

Explorar los recursos y herramientas disponibles
Pruebe las operaciones grep con diferentes parámetros
Ver resultados formateados
Problemas de depuración con sus consultas grep

Desarrollo

# Clone the repository
git clone https://github.com/erniebrodeur/mcp-grep.git
cd mcp-grep

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest