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

Basic information

Category

Other

License

GPL-3.0

Runtime

python

Transports

stdio

Publisher

erniebrodeur

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.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K