MCP Ripgrep Server

MCP Ripgrep Server

Un servidor MCP que proporciona capacidades de búsqueda ripgrep (rg) a cualquier cliente MCP como Claude.

Resumen

Este servidor proporciona una interfaz de Protocolo de Contexto de Modelo (MCP) para la potente herramienta de búsqueda ripgrep. Permite a Claude AI y a otros clientes compatibles con MCP realizar búsquedas de texto de alto rendimiento en archivos de tu sistema.

Requisitos previos

• Node.js (v18 o superior)
• El comando ripgrep (rg) instalado y disponible en tu PATH. Instálalo con brew install ripgrep en macOS.

Uso con Claude for Desktop

Para usar este servidor MCP con Claude for Desktop:

1. Edita tu archivo de configuración de Claude for Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Añade lo siguiente a tu configuración:

   {
     "mcpServers": {
       "ripgrep": {
         "command": "npx",
         "args": ["-y", "mcp-ripgrep@latest"]
       }
     }
   }
   

   Reemplaza /path/to/mcp-ripgrep con la ruta absoluta a donde clonaste este repositorio.

3. Reinicia Claude for Desktop.

Herramientas disponibles

search

Búsqueda básica con ripgrep:

Pattern: error
Path: ./src

advanced-search

Búsqueda más avanzada con opciones adicionales:

Pattern: function
Path: ./src
FixedStrings: true
FileType: ts
IncludeHidden: false

count-matches

Cuenta las apariciones de un patrón:

Pattern: TODO
Path: ./src
CountLines: true

list-files

Lista los archivos que se buscarían sin realizar realmente la búsqueda:

Path: ./src
FileType: js

list-file-types

Lista todos los tipos de archivo compatibles con ripgrep.

Consideraciones de seguridad

Este servidor MCP ejecuta comandos de shell usando la herramienta ripgrep. Aunque se han realizado esfuerzos para escapar los argumentos de forma segura, ten precaución al proporcionar datos, ya que ejecuta comandos en tu máquina.

Licencia

MIT