MCP.so
Sign In

MCP-Grep

@erniebrodeur

Repository

About MCP-Grep

simple mcp server to wrap the local instance of grep.

#mcp#vscode#anthropic#mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-grep": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@erniebrodeur/mcp-grep",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP-Grep?

MCP-Grep exposes system grep functionality through the Model Context Protocol (MCP), allowing MCP-compatible clients to search file contents using regular expressions. It is designed for developers and LLM-based tools that need to inspect local files efficiently.

How to use MCP-Grep?

Install via pip install mcp-grep or automatically through Smithery. Start the server with the command mcp-grep-server, or use mcp-grep-inspector for an interactive web UI. Connect any MCP-compatible client to access the grep tool and the grep://info resource.

Key features of MCP-Grep

  • Provides system binary info via the grep://info resource.
  • Supports case‑insensitive matching, context lines, and recursion.
  • Accepts natural language prompts for easier LLM interaction.
  • Includes an interactive MCP Inspector for debugging.
  • Enables fixed string (non‑regex) searches and match limits.

Use cases of MCP-Grep

  • Search for error patterns in log files during debugging.
  • Recursively find deprecated API usage across a project.
  • Query codebases with natural language requests through an LLM.
  • Test and refine grep queries interactively in a web UI.

FAQ from MCP-Grep

How do I install MCP-Grep?

Use pip install mcp-grep for manual installation, or run npx -y @smithery/cli install @erniebrodeur/mcp-grep --client claude to install via Smithery for Claude Desktop.

What commands start the server?

Run mcp-grep-server to start the MCP server, or mcp-grep-inspector to launch the interactive web‑based inspector.

What search options does the grep tool support?

It supports case‑insensitive matching, context lines before/after matches, maximum match count, fixed string matching, and recursive directory searching.

How can I use natural language prompts?

MCP-Grep accepts plain‑English requests like “Find ‘error’ in log.txt” or “Show 3 lines of context around ‘exception’.” The server interprets the intent and sets the correct grep parameters.

Does MCP-Grep require any external dependencies?

It uses the system’s grep binary and the mcp-grep Python package. No additional runtime or cloud service is needed.

Frequently asked questions

How do I install MCP-Grep?

Use `pip install mcp-grep` for manual installation, or run `npx -y @smithery/cli install @erniebrodeur/mcp-grep --client claude` to install via Smithery for Claude Desktop.

What commands start the server?

Run `mcp-grep-server` to start the MCP server, or `mcp-grep-inspector` to launch the interactive web‑based inspector.

What search options does the grep tool support?

It supports case‑insensitive matching, context lines before/after matches, maximum match count, fixed string matching, and recursive directory searching.

How can I use natural language prompts?

MCP-Grep accepts plain‑English requests like “Find ‘error’ in log.txt” or “Show 3 lines of context around ‘exception’.” The server interprets the intent and sets the correct grep parameters.

Does MCP-Grep require any external dependencies?

It uses the system’s `grep` binary and the `mcp-grep` Python package. No additional runtime or cloud service is needed.

Comments

Basic information

Category

Other

License

GPL-3.0

Transports

stdio

Author

erniebrodeur

More Other MCP servers

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Mobile Mcp

mobile-next

Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)

5.4K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K