MCP-Grep

Name: MCP-Grep
Author: erniebrodeur

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