Máy chủ MCP-Grep MCP

Máy chủ MCP “MCP-Grep” làm gì?

MCP-Grep là một máy chủ Model Context Protocol (MCP) bao bọc phiên bản cục bộ của tiện ích Unix grep, giúp chức năng tìm kiếm mạnh mẽ của nó trở nên dễ tiếp cận cho trợ lý AI và các client tương thích MCP. Bằng cách cung cấp grep như tài nguyên và công cụ, MCP-Grep cho phép hệ thống AI và nhà phát triển thực hiện tìm kiếm mẫu nâng cao, phân tích văn bản và khám phá file thông qua API chuẩn hóa. Điều này giúp cho các quy trình như tìm mẫu trong mã nguồn, log hoặc tài liệu, lấy ngữ cảnh xung quanh kết quả trùng khớp, và tương tác với tập tin thực thi grep của hệ thống để lấy thông tin về khả năng của nó. MCP-Grep nâng cao quy trình phát triển và gỡ lỗi nhờ hỗ trợ prompt ngôn ngữ tự nhiên, tích hợp với LLM và khám phá tương tác thông qua MCP Inspector.

Danh sách Prompt

• MCP-Grep hỗ trợ prompt ngôn ngữ tự nhiên để sử dụng dễ dàng với LLM. Ví dụ về các mẫu prompt được hỗ trợ:
  • Tìm kiếm cơ bản: Tìm kiếm ‘pattern’ trong filename
  • Tìm kiếm không phân biệt hoa/thường: Tìm tất cả các trường hợp ‘PATTERN’ bất kể chữ hoa/thường trong filename
  • Tìm kiếm kèm dòng ngữ cảnh: Tìm kiếm ‘pattern’ trong filename và hiển thị N dòng trước và sau mỗi lần trùng khớp
  • Tìm kiếm đệ quy thư mục: Tìm tất cả các lần xuất hiện của ‘pattern’ trong thư mục và các thư mục con
  • Tìm kiếm chuỗi cố định: Tìm kiếm chính xác chuỗi ‘pattern’ trong filename
  • Giới hạn kết quả: Hiển thị N lần xuất hiện đầu tiên của ‘pattern’ trong filename
  • Kết hợp nhiều tuỳ chọn: Tìm ‘pattern’ không phân biệt hoa/thường trong tất cả các tập tin phù hợp, hiển thị ngữ cảnh và giới hạn kết quả

Danh sách Tài nguyên

• grep://info
  Trả về thông tin về tập tin thực thi grep của hệ thống, bao gồm đường dẫn, phiên bản và các tính năng hỗ trợ.

Danh sách Công cụ

• grep
  Tìm kiếm mẫu trong các file bằng tập tin thực thi grep của hệ thống. Hỗ trợ các tuỳ chọn như tìm kiếm không phân biệt hoa/thường, dòng ngữ cảnh, số lượng kết quả tối đa, tìm kiếm chuỗi cố định và tìm kiếm đệ quy thư mục.

Các trường hợp sử dụng của máy chủ MCP này

• Phân tích Log:
  Nhanh chóng tìm thông báo lỗi hoặc mẫu cụ thể trong các tập tin log lớn, tối ưu hoá việc gỡ lỗi và tự động giám sát log.
• Khám phá mã nguồn:
  Tìm định nghĩa hàm, cách sử dụng biến hoặc mẫu mã đã ngừng sử dụng trong kho mã nguồn lớn.
• Tìm kiếm file cấu hình:
  Xác định tham số cấu hình hoặc thiết lập cụ thể trong nhiều file cấu hình trên các thư mục để kiểm toán hoặc xử lý sự cố.
• Kiểm toán bảo mật:
  Nhận diện secret hardcoded, mật khẩu hoặc mẫu không an toàn trong mã nguồn hoặc file cho các đánh giá bảo mật.
• Tìm kiếm tài liệu:
  Tìm kiếm trong các file tài liệu để nhanh chóng xác định phần liên quan, thuật ngữ hoặc cập nhật.

Cách thiết lập

Windsurf

1. Đảm bảo Python và mcp-grep đã được cài đặt: pip install mcp-grep
2. Xác định vị trí file cấu hình Windsurf của bạn (ví dụ: windsurf.config.json)
3. Thêm máy chủ MCP-Grep vào phần mcpServers với JSON sau:

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

4. Lưu cấu hình và khởi động lại Windsurf.
5. Xác nhận máy chủ đã khả dụng qua giao diện MCP của Windsurf.

Claude

1. Cài đặt bằng Smithery:

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

2. Mở file cấu hình của Claude Desktop.
3. Thêm MCP-Grep làm máy chủ:

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

4. Lưu và khởi động lại Claude Desktop.
5. Xác nhận tích hợp qua bảng điều khiển máy chủ.

Cursor

1. Cài đặt mcp-grep: pip install mcp-grep
2. Cập nhật file cấu hình MCP của Cursor.
3. Thêm mục:

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

4. Lưu cấu hình và khởi động lại Cursor.
5. Kiểm tra công cụ MCP bên trong Cursor.

Cline

1. Cài đặt mcp-grep qua pip: pip install mcp-grep
2. Xác định vị trí file cấu hình MCP của Cline.
3. Thêm vào:

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

4. Lưu và khởi động lại ứng dụng.
5. Xác nhận Cline đã nhận diện máy chủ MCP.

Bảo mật API Key

Nếu cần thiết lập biến môi trường (ví dụ cho các cấu hình nâng cao), hãy sử dụng mẫu sau:

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

Lưu ý: MCP-Grep mặc định không yêu cầu API key, nhưng đây là ví dụ cho cách bảo mật secret.

Cách sử dụng MCP này trong các flow

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt, hãy bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với agent AI của bạn:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình hệ thống MCP, nhập thông tin máy chủ MCP của bạn theo định dạng JSON sau:

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

Sau khi cấu hình, agent AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và khả năng của nó. Lưu ý thay “mcp-grep” bằng tên thực tế của máy chủ MCP của bạn và thay URL bằng địa chỉ máy chủ MCP của bạn.

Tổng quan

Ý kiến của chúng tôi

MCP-Grep cung cấp một triển khai tập trung, có tài liệu tốt của MCP cho tiện ích grep phổ biến. Nó có các tài nguyên rõ ràng, định nghĩa công cụ và hướng dẫn thiết lập, nhưng không tài liệu về tính năng Roots hay Sampling. Sự đơn giản và tài liệu hướng dẫn giúp nó là lựa chọn tốt cho nhà phát triển cần khả năng tìm kiếm, tuy nhiên các tính năng MCP nâng cao chưa được đề cập.

Điểm MCP

Đánh giá: 7/10
MCP-Grep mạnh về chức năng cốt lõi và tài liệu nhưng chưa đề cập rõ các tính năng MCP nâng cao như Roots và Sampling. Đây là máy chủ thực tế và phù hợp cho các tác vụ tìm kiếm.