Servidor MCP Ripgrep

Um servidor MCP que fornece capacidades de busca ripgrep (rg) para qualquer cliente MCP, como o Claude.

Visão Geral

Este servidor fornece uma interface de Protocolo de Contexto de Modelo (MCP) para a poderosa ferramenta de busca ripgrep. Ele permite que o Claude AI e outros clientes compatíveis com MCP realizem buscas de texto de alto desempenho em arquivos do seu sistema.

Pré-requisitos

Node.js (v18 ou superior)
Comando ripgrep (rg) instalado e disponível no seu PATH. Instale-o com brew install ripgrep no macOS.

Uso com Claude para Desktop

Para usar este servidor MCP com o Claude para Desktop:

Edite o arquivo de configuração do Claude para Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione o seguinte à sua configuração:
```
{
  "mcpServers": {
    "ripgrep": {
      "command": "npx",
      "args": ["-y", "mcp-ripgrep@latest"]
    }
  }
}
```
Substitua /path/to/mcp-ripgrep pelo caminho absoluto para onde você clonou este repositório.
Reinicie o Claude para Desktop.

Ferramentas Disponíveis

search

Busca básica com ripgrep:

Pattern: error
Path: ./src

advanced-search

Busca mais avançada com opções adicionais:

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

count-matches

Conta ocorrências de um padrão:

Pattern: TODO
Path: ./src
CountLines: true

list-files

Lista arquivos que seriam pesquisados sem realmente pesquisá-los:

Path: ./src
FileType: js

list-file-types

Lista todos os tipos de arquivo suportados no ripgrep.

Considerações de Segurança

Este servidor MCP executa comandos de shell usando a ferramenta ripgrep. Embora esforços tenham sido feitos para escapar argumentos com segurança, tenha cautela ao fornecer entrada, pois ele executa comandos na sua máquina.

Licença

MIT

MCP Ripgrep Server

Documentação