MCP-Grep MCP-Server

Was macht der „MCP-Grep“ MCP-Server?

MCP-Grep ist ein Model Context Protocol (MCP) Server, der die lokale Unix-Instanz von grep einbindet und dessen leistungsstarke Suchfunktionalität für KI-Assistenten und MCP-kompatible Clients zugänglich macht. Durch die Bereitstellung von grep als Ressource und Tool ermöglicht MCP-Grep KI-Systemen und Entwicklern, fortschrittliche Mustersuchen, Textanalysen und Datei-Erkundungen über eine standardisierte API auszuführen. Damit lassen sich Workflows wie das Durchsuchen von Codebasen, Logs oder Dokumenten, das Abrufen von Kontext zu Treffern und die Interaktion mit der System-grep-Binary für Informationen zu deren Fähigkeiten realisieren. MCP-Grep erweitert Entwicklungs- und Debugging-Workflows durch Unterstützung für natürliche Sprachprompts, Integration mit LLMs und interaktive Erkundung via MCP Inspector.

Liste der Prompts

• MCP-Grep unterstützt natürliche Sprachprompts für die leichtere Nutzung mit LLMs. Beispiele für unterstützte Prompt-Vorlagen:
  • Einfache Suche: Suche nach ‘Muster’ in Dateiname
  • Groß-/Kleinschreibungs-unabhängige Suche: Finde alle Vorkommen von ‘MUSTER’ unabhängig von der Groß-/Kleinschreibung in Dateiname
  • Suche mit Kontextzeilen: Suche nach ‘Muster’ in Dateiname und zeige N Zeilen vor und nach jedem Treffer
  • Rekursive Verzeichnissuche: Finde alle Vorkommen von ‘Muster’ im Verzeichnis und Unterverzeichnissen
  • Feste Zeichenkettensuche: Suche nach dem exakten String ‘Muster’ in Dateiname
  • Begrenzte Ergebnisse: Zeige die ersten N Vorkommen von ‘Muster’ in Dateiname
  • Mehrere Optionen kombiniert: Finde ‘Muster’ groß-/kleinschreibungs-unabhängig in allen Dateien laut Kriterium, zeige Kontext und begrenze Ergebnisse

Liste der Ressourcen

• grep://info
  Gibt Informationen über die System-grep-Binary aus, einschließlich Pfad, Version und unterstützter Funktionen.

Liste der Tools

• grep
  Sucht nach Mustern in Dateien mit der System-grep-Binary. Unterstützt Optionen wie Groß-/Kleinschreibungs-unabhängige Suche, Kontextzeilen, maximale Trefferanzahl, feste Zeichenkettensuche und rekursive Verzeichnissuche.

Anwendungsfälle dieses MCP-Servers

• Log-Analyse:
  Durchsuchen Sie große Logdateien nach bestimmten Fehlermeldungen oder Mustern, beschleunigen Sie Debugging und automatisieren Sie Log-Monitoring.
• Codebasis-Erkundung:
  Finden Sie Funktionsdefinitionen, Variablenverwendungen oder veraltete Code-Muster in umfangreichen Quellcode-Repositorien.
• Konfigurationsdatei-Suche:
  Lokalisieren Sie spezifische Konfigurationsparameter oder Einstellungen in mehreren Konfigurationsdateien über Verzeichnisse hinweg für Audits oder Fehlersuche.
• Sicherheitsprüfungen:
  Identifizieren Sie fest codierte Geheimnisse, Passwörter oder unsichere Muster in Codebasen oder Dateien für Security Reviews.
• Dokumentationssuche:
  Durchsuchen Sie Dokumentationsdateien, um schnell relevante Abschnitte, Begriffe oder Aktualisierungen zu finden.

Einrichtung

Windsurf

1. Stellen Sie sicher, dass Python und mcp-grep installiert sind: pip install mcp-grep
2. Suchen Sie Ihre Windsurf-Konfigurationsdatei (z.B. windsurf.config.json)
3. Fügen Sie den MCP-Grep-Server im Abschnitt mcpServers mit folgendem JSON hinzu:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. Speichern Sie die Konfiguration und starten Sie Windsurf neu.
5. Prüfen Sie, ob der Server über die MCP-Oberfläche von Windsurf erreichbar ist.

Claude

1. Mit Smithery installieren:

   npx -y @smithery/cli install @erniebrodeur/mcp-grep --client claude
   

2. Öffnen Sie die Konfigurationsdatei von Claude Desktop.
3. Fügen Sie MCP-Grep als Server hinzu:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. Speichern und starten Sie Claude Desktop neu.
5. Bestätigen Sie die Integration über das Server-Panel.

Cursor

1. Installieren Sie mcp-grep: pip install mcp-grep
2. Aktualisieren Sie die MCP-Konfigurationsdatei von Cursor.
3. Fügen Sie folgenden Eintrag hinzu:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. Konfiguration speichern und Cursor neu starten.
5. Prüfen Sie die Verfügbarkeit des MCP-Tools innerhalb von Cursor.

Cline

1. Installieren Sie mcp-grep via pip: pip install mcp-grep
2. Suchen Sie Ihre Cline-MCP-Konfigurationsdatei.
3. Fügen Sie ein:

   {
     "mcpServers": {
       "mcp-grep": {
         "command": "mcp-grep-server",
         "args": []
       }
     }
   }
   

4. Speichern und Anwendung neu starten.
5. Prüfen Sie, ob Cline den MCP-Server erkennt.

API-Schlüssel absichern

Falls Sie Umgebungsvariablen setzen müssen (z.B. für erweiterte Setups), nutzen Sie dieses Muster:

{
  "mcpServers": {
    "mcp-grep": {
      "command": "mcp-grep-server",
      "args": [],
      "env": {
        "MY_SECRET_API_KEY": "${MY_SECRET_API_KEY}"
      },
      "inputs": {
        "api_key": "${MY_SECRET_API_KEY}"
      }
    }
  }
}

Hinweis: MCP-Grep benötigt standardmäßig keinen API-Schlüssel. Dieses Beispiel zeigt das Muster für sichere Geheimnisse.

Nutzung dieses MCP in Flows

MCP in FlowHunt verwenden

Um MCP-Server in Ihren FlowHunt-Workflow einzubinden, fügen Sie zunächst die MCP-Komponente zu Ihrem Flow hinzu und verbinden sie mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. Im Bereich zur System-MCP-Konfiguration tragen Sie Ihre MCP-Serverdetails in folgendem JSON-Format ein:

{
  "mcp-grep": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Nach der Konfiguration kann der KI-Agent diesen MCP als Tool mit Zugriff auf alle Funktionen und Möglichkeiten nutzen. Denken Sie daran, “mcp-grep” durch den tatsächlichen Namen Ihres MCP-Servers und die URL durch Ihre eigene MCP-Server-URL zu ersetzen.

Übersicht

Unsere Meinung

MCP-Grep liefert eine fokussierte, gut dokumentierte MCP-Implementierung für das beliebte grep-Tool. Es bietet klare Ressourcen, Tool-Definitionen und Setup-Anleitungen, dokumentiert aber keine Unterstützung für Roots oder Sampling. Seine Einfachheit und Dokumentation machen es zu einer soliden Wahl für Entwickler, die Suchfunktionen benötigen – fortgeschrittene MCP-Features werden jedoch nicht abgedeckt.

MCP-Score

Bewertung: 7/10
MCP-Grep überzeugt in Kernfunktionalität und Dokumentation, es fehlen aber ausdrücklich fortgeschrittene MCP-Features wie Roots und Sampling. Es ist ein praktischer und klar abgegrenzter Server für Suchaufgaben.