@atef_andrus/mcp-ripgrep
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@atef_andrus/mcp-ripgrep search for 'async' in all TypeScript files"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@atef_andrus/mcp-ripgrep
An MCP server that provides ripgrep search capabilities.
Prerequisites
ripgrep (
rg) installed and available on PATHNode.js 22+ or Bun 1.3+
Related MCP server: ripgrep-mcp
Installation
npm install @atef_andrus/mcp-ripgrepUsage
Use as an MCP Server
Add the following to your MCP client configuration:
{
"mcpServers": {
"ripgrep": {
"command": "npx",
"args": ["@atef_andrus/mcp-ripgrep"]
}
}
}Startup Options
Option | Description |
| Restrict search scope to the specified directory (can be specified multiple times) |
| Maximum characters in results. Truncates at line boundaries when exceeded (default: 50,000) |
| Maximum bytes of ripgrep output. Terminates the process and truncates results when exceeded (default: 20 MB) |
Configuration example with startup options:
{
"mcpServers": {
"ripgrep": {
"command": "npx",
"args": [
"@atef_andrus/mcp-ripgrep",
"--allow-dir", "/home/user/project",
"--max-result-chars", "50000",
"--max-output-bytes", "20000000"
]
}
}
}Tools
Tool | Description |
| Pattern search with regex, literal strings, multiline matching, OR matching, context lines, and various filters. Prepends a summary of match count and file count to results |
| Search-and-replace preview (read-only). Supports multiline matching and capture groups ($1, ${name}) |
| Count matches per file (by line count or total matches). Supports sorting results |
| List files that match or do not match a pattern |
| List all files within the search scope |
| List file types supported by ripgrep |
Key Parameters
Parameter | Description |
| Search pattern (regex by default) |
| Directory or file to search |
| Treat the pattern as a literal string |
|
|
| Filter by file type (e.g., |
| Exclude file types (e.g., |
| Filter by glob pattern (e.g., |
| Include hidden files |
| Follow symbolic links |
| Maximum directory traversal depth |
| Ignore .gitignore rules and search files that are normally excluded |
| Enable multiline matching (function signatures, import blocks, etc.) |
| Additional patterns for OR matching (array) |
| Sort results. search / search-files / list-files: |
| Maximum characters in results. Truncates at line boundaries and appends a summary when exceeded |
Parameter Support by Tool
Parameter |
|
|
|
|
|
|
| - | - | o | o | o | o |
| - | o | o | o | o | o |
| - | - | o | o | o | o |
| - | - | o | o | o | o |
| - | - | o | o | o | o |
| - | - | o | o | - | - |
| - | o | o | o | o | o |
| - | o | o | o | o | o |
| - | o | o | o | o | o |
| - | - | o | o | - | - |
| - | - | o | - | - | - |
| - | - | o | - | - | - |
| - | - | o | - | - | - |
| - | - | o | - | - | o |
| - | o | o | o | o | o |
| - | o | o | o | o | o |
| - | o | o | o | o | o |
| - | - | o | - | - | - |
| - | - | o | - | - | - |
| - | - | o | - | - | - |
| - | o | o | o | o | o |
| - | o | o | - | o | o |
| o | o | o | o | o | o |
| - | - | - | o | - | - |
| - | - | - | o | - | - |
| - | - | - | - | o | - |
| - | - | - | - | o | - |
Development
# Install dependencies
bun install
# Run tests
bun test
# Type check
bunx tsc --noEmit
# Lint and format
bunx biome check --write .
# Build
bunx tsc
# Start in development mode
bun run devSecurity
This server passes arguments as an array via
spawn("rg", args)(no shell interpolation). Patterns and paths are placed after a--separator to prevent flag injection.The
--allow-diroption restricts the search scope to specified directories. Paths are resolved to absolute paths usingpath.resolve()and validated via prefix matching.Limitation: When
followSymlinksis enabled, symbolic links may allow access to directories outside the allowed scope. Be aware of this when using--allow-dirtogether withfollowSymlinks.
License
MIT
Available Tools
6 toolslist-filesRipgrep List FilesA
List all files in the search scope using ripgrep. No pattern matching — just lists files that would be searched.
Inputs: path (required), glob, sortBy, fileType, +6 more.
list-file-typesRipgrep List File TypesA
List all file types supported by ripgrep. Useful for finding valid values for the fileType parameter.
Inputs: maxCharacters.
searchRipgrep SearchA
Search file contents for a pattern using ripgrep. Supports regex, literal strings, multiline matching, OR matching via additionalPatterns, and various filtering options. For large or unfamiliar codebases, consider using search-count or search-files first to assess the scope of matches.
Inputs: path (required), pattern (required), glob, sortBy, +19 more.
search-and-replaceRipgrep Search and Replace PreviewA
Read-only preview of search-and-replace results using ripgrep. Does NOT modify files. Useful for previewing replacements and testing capture groups ($1, $2, ${name}).
Inputs: path (required), pattern (required), replacement (required), glob, +13 more.
search-countRipgrep Search CountB
Count pattern matches per file using ripgrep. Returns file paths with their match counts.
Inputs: path (required), pattern (required), glob, sortBy, +12 more.
search-filesRipgrep Search FilesA
List files that match (or do not match) a pattern using ripgrep. Returns file paths only, no line content.
Inputs: path (required), pattern (required), glob, sortBy, +11 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool exposes a distinct ripgrep operation: content search, count, file-list matching, all-file listing, file-type listing, and a read-only replace preview. Descriptions clearly differentiate outputs and use cases, leaving minimal risk of misselection.
Names follow a lowercase-hyphenated convention (search, search-count, search-files, list-files, list-file-types), which is readable and mostly predictable. Minor inconsistencies exist: 'search' is a bare verb and 'search-and-replace' uses a compound phrase rather than a strict verb_noun pattern.
Six tools are well-scoped for a ripgrep wrapper, covering the core search, count, listing, and preview operations without redundancy. Each tool earns its place and the set avoids bloat.
The surface covers ripgrep's main search and inspection workflows: pattern search, counting, file matching, full file listing, file-type enumeration, and replace preview. A minor gap is the lack of an actual file-modification tool, but the read-only design is clearly intentional.
Related MCP Connectors
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
A MCP server built for developers enabling Git based project management with project and personal…
MCP server for accessing curated awesome list documentation
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides ripgrep search capabilities to MCP clients like Claude, allowing high-performance text searches across files on your system.53,723 npm79MIT
- AlicenseAqualityDmaintenanceProvides ripgrep search capabilities to MCP clients like Claude, enabling high-performance text searches across files on your system.515 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for local-first lexical code search, providing tools for searching code, finding symbols, and reading chunks from indexed repositories.MIT
- AlicenseNot gradedqualityDmaintenanceA stdio-based MCP server for fast, bounded search and navigation of large code repositories using ripgrep, with tools for project-wide search, symbol lookup, file listing, and code reading.5 npm1MIT