Ripgrep
Provides high-performance text search across your local files using the ripgrep tool. Lets you search for patterns, count matches, and explore file contents from within MCP-compatible applications.
Provides high-performance text search capabilities by wrapping ripgrep, enabling powerful file exploration, pattern matching, and content discovery across local filesystems.
What it does
- Search files for text patterns
- Count pattern matches in files
- List files by type without searching
- Perform advanced searches with filters
- View supported file types
Best for
About Ripgrep
Ripgrep is a community-built MCP server published by mcollina that provides AI assistants with tools and capabilities via the Model Context Protocol. Ripgrep offers high-performance text search, ideal for SEO optimization software and rapid content discovery across loca It is categorized under file systems, developer tools. This server exposes 5 tools that AI clients can invoke during conversations and coding sessions.
How to install
You can install Ripgrep in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
Ripgrep is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (5)
Search files for patterns using ripgrep (rg)
Advanced search with ripgrep with more options
Count matches in files using ripgrep
List files that would be searched by ripgrep without actually searching them
List all supported file types in ripgrep
MCP Ripgrep Server
An MCP server that provides ripgrep (rg) search capabilities to any MCP client such as Claude.
Overview
This server provides a Model Context Protocol (MCP) interface for the powerful ripgrep search tool. It enables Claude AI and other MCP-compatible clients to perform high-performance text searches across files on your system.
Prerequisites
- Node.js (v18 or higher)
- ripgrep (
rg) command installed and available in your PATH. Install it withbrew install ripgrepon macOS.
Usage with Claude for Desktop
To use this MCP server with Claude for Desktop:
-
Edit your Claude for Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the following to your configuration:
{ "mcpServers": { "ripgrep": { "command": "npx", "args": ["-y", "mcp-ripgrep@latest"] } } }Replace
/path/to/mcp-ripgrepwith the absolute path to where you cloned this repository. -
Restart Claude for Desktop.
Available Tools
search
Basic search with ripgrep:
Pattern: error
Path: ./src
advanced-search
More advanced search with additional options:
Pattern: function
Path: ./src
FixedStrings: true
FileType: ts
IncludeHidden: false
count-matches
Count occurrences of a pattern:
Pattern: TODO
Path: ./src
CountLines: true
list-files
List files that would be searched without actually searching them:
Path: ./src
FileType: js
list-file-types
List all supported file types in ripgrep.
Security Considerations
This MCP server executes shell commands using the ripgrep tool. While efforts have been made to safely escape arguments, use caution when providing input as it runs commands on your machine.
License
MIT
Alternatives
Related Skills
Browse all skillsThis skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.
UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use for creating design systems, maintaining visual consistency, and facilitating design-dev collaboration.
Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.
Answer questions about the AI SDK and help build AI-powered features. Use when developers: (1) Ask about AI SDK functions like generateText, streamText, ToolLoopAgent, embed, or tools, (2) Want to build AI agents, chatbots, RAG systems, or text generation features, (3) Have questions about AI providers (OpenAI, Anthropic, Google, etc.), streaming, tool calling, structured output, or embeddings, (4) Use React hooks like useChat or useCompletion. Triggers on: "AI SDK", "Vercel AI SDK", "generateText", "streamText", "add AI to my app", "build an agent", "tool calling", "structured output", "useChat".
Comprehensive CrewAI framework guide for building collaborative AI agent teams and structured workflows. Use when developing multi-agent systems with CrewAI, creating autonomous AI crews, orchestrating flows, implementing agents with roles and tools, or building production-ready AI automation. Essential for developers building intelligent agent systems, task automation, and complex AI workflows.
Use when building MCP servers or clients that connect AI systems with external tools and data sources. Invoke for MCP protocol compliance, TypeScript/Python SDKs, resource providers, tool functions.