MCP-Grep

モデルコンテキストプロトコル (MCP) を通じて grep 機能を公開する grep サーバー実装。

インストール

pip install mcp-grep

Related MCP server: cve-search_mcp

使用法

MCP-Grep は、MCP 互換クライアントが使用できるサーバーとして実行されます。

# Start the MCP-Grep server
mcp-grep-server

# Or use the MCP Inspector for interactive debugging and testing
mcp-grep-inspector

サーバーは次の MCP 機能を公開します。

リソース: grep://info - システム grep バイナリに関する情報を返します
ツール: grep - システムの grep バイナリを使用してファイル内のパターンを検索します

特徴

システム grep バイナリに関する情報 (パス、バージョン、サポートされている機能)
正規表現を使用してファイル内のパターンを検索する
一般的な grep オプションのサポート:
- 大文字と小文字を区別しないマッチング
- コンテキスト行（一致の前後）
- 最大一致数
- 固定文字列マッチング（非正規表現）
- 再帰ディレクトリ検索
LLM での使いやすさを向上させる自然言語プロンプトの理解
MCP Inspectorによるインタラクティブなデバッグとテスト

APIの使用例

MCP Python クライアントの使用:

from mcp.client import MCPClient

# Connect to the MCP-Grep server
client = MCPClient()

# Get information about the grep binary
grep_info = client.get_resource("grep://info")
print(grep_info)

# Search for a pattern in files
result = client.use_tool("grep", {
    "pattern": "search_pattern",
    "paths": ["file.txt", "directory/"],
    "ignore_case": True,
    "recursive": True
})
print(result)

自然言語プロンプト

MCP-Grep は自然言語プロンプトを理解するため、LLM での使用が容易になります。例:

# Basic search
Search for 'error' in log.txt

# Case-insensitive search
Find all instances of 'WARNING' regardless of case in system.log

# With context lines
Search for 'exception' in error.log and show 3 lines before and after each match

# Recursive search
Find all occurrences of 'deprecated' in the src directory and its subdirectories

# Fixed string search (non-regex)
Search for the exact string '.*' in config.js

# Limited results
Show me just the first 5 occurrences of 'TODO' in the project files

# Multiple options
Find 'password' case-insensitively in all .php files, show 2 lines of context, and limit to 10 results

MCPインスペクター統合

MCP-Grep には、対話型のデバッグとテストのための MCP Inspector 統合が含まれています。

# Start the MCP Inspector with MCP-Grep
mcp-grep-inspector

これにより、Web ベースの UI が開き、次の操作を実行できます。

利用可能なリソースとツールを調べる
異なるパラメータでgrep操作をテストする
フォーマットされた結果を表示
grepクエリの問題をデバッグする

発達

# Clone the repository
git clone https://github.com/erniebrodeur/mcp-grep.git
cd mcp-grep

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest