MCP-Grep MCP 服务器

“MCP-Grep” MCP 服务器能做什么？

MCP-Grep 是一个模型上下文协议（MCP）服务器，封装了本地 Unix grep 工具，将其强大的搜索功能开放给 AI 助手和兼容 MCP 的客户端。MCP-Grep 既作为资源也作为工具，将 grep 暴露出来，使 AI 系统和开发者可以通过标准化 API 实现高级模式搜索、文本分析和文件探索任务。这让诸如在代码库、日志或文档中搜索模式、获取匹配上下文、与系统 grep 二进制交互并了解其功能等工作流成为可能。MCP-Grep 还通过对自然语言提示、与大模型集成及 MCP Inspector 的交互式探索，极大增强了开发和调试体验。

提示词模板示例

• MCP-Grep 支持与大模型协作的自然语言提示。支持的模板示例如下：
  • 基础搜索： 在文件 filename 中搜索 ‘pattern’
  • 忽略大小写搜索： 在文件 filename 中查找所有 ‘PATTERN’（不区分大小写）
  • 带上下文行搜索： 在文件 filename 中搜索 ‘pattern’，并显示每个匹配前后 N 行
  • 递归目录搜索： 在目录及其子目录下查找所有 ‘pattern’
  • 精确字符串搜索： 在文件 filename 中搜索精确字符串 ‘pattern’
  • 限制结果数： 显示文件 filename 中前 N 个 ‘pattern’ 匹配
  • 多选项组合： 在所有符合条件的文件中忽略大小写查找 ‘pattern’，显示上下文，限制结果数

资源列表

• grep://info
  返回系统 grep 二进制的信息，包括路径、版本和支持的功能。

工具列表

• grep
  使用系统 grep 二进制在文件中搜索模式。支持如忽略大小写、上下文行、最大匹配数、精确字符串、递归目录等选项。

典型应用场景

• 日志分析：
  快速在大型日志文件中搜索特定错误信息或模式，简化调试并自动化日志监控。
• 代码库探索：
  在大型源码库中查找函数定义、变量用法或废弃代码模式。
• 配置文件搜索：
  在多个目录下的配置文件中定位特定参数或设置，便于审计和排查。
• 安全审计：
  在代码库或文件中识别硬编码密钥、密码或不安全模式，助力安全检查。
• 文档检索：
  在文档文件中快速定位相关章节、术语或更新内容。

如何配置

Windsurf

1. 确保已安装 Python 和 mcp-grep：pip install mcp-grep
2. 找到你的 Windsurf 配置文件（如 windsurf.config.json）
3. 在 mcpServers 部分添加 MCP-Grep 服务器，示例 JSON 如下：

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

4. 保存配置并重启 Windsurf。
5. 通过 Windsurf 的 MCP 界面验证服务器可用性。

Claude

1. 使用 Smithery 安装：

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

2. 打开 Claude Desktop 的配置文件。
3. 添加 MCP-Grep 服务器：

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

4. 保存并重启 Claude Desktop。
5. 通过服务器面板确认集成成功。

Cursor

1. 安装 mcp-grep：pip install mcp-grep
2. 更新 Cursor 的 MCP 配置文件。
3. 添加条目：

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

4. 保存配置并重启 Cursor。
5. 在 Cursor 内检查 MCP 工具可用性。

Cline

1. 通过 pip 安装 mcp-grep：pip install mcp-grep
2. 找到你的 Cline MCP 配置文件。
3. 插入如下内容：

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

4. 保存并重启应用。
5. 验证 Cline 是否识别 MCP 服务器。

API 密钥安全配置

如需设置环境变量（如高级配置场景），可参考如下格式：

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

注意：MCP-Grep 默认不需要 API 密钥，此处仅演示安全密钥配置模式。

如何在流程中使用 MCP

在 FlowHunt 中集成 MCP

要将 MCP 服务器集成到 FlowHunt 工作流，首先将 MCP 组件添加到流程中，并连接到你的 AI 智能体：

点击 MCP 组件打开配置面板。在系统 MCP 配置区，使用如下 JSON 格式填写你的 MCP 服务器信息：

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

配置完成后，AI 智能体即可作为工具使用此 MCP 并访问其所有功能。请将 “mcp-grep” 替换为你的实际 MCP 服务器名称，并将 URL 替换为你自己的 MCP 服务器地址。

概览

我们的看法

MCP-Grep 针对流行的 grep 工具实现了聚焦且文档完善的 MCP 方案。其资源、工具定义和配置说明清晰明了，但未涉及 Roots 或采样支持。简单易用和文档完善使其成为需要搜索能力开发者的理想选择，但未覆盖高级 MCP 特性。

MCP 评分

评分： 7/10
MCP-Grep 在核心功能和文档方面表现出色，但缺乏对 Roots 和采样等高级 MCP 功能的明确支持。它是一个实用且定位清晰的搜索任务服务器。