Máy chủ Lucene MCP

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

MCP Lucene Server là một triển khai Model Context Protocol (MCP) dựa trên Java được thiết kế nhằm cung cấp khả năng tìm kiếm và truy xuất hiệu quả bằng cách sử dụng Apache Lucene. Hoạt động như một máy chủ tuân thủ MCP, nó cho phép trợ lý AI và các agent tương tác với kho tài liệu lớn cho các tác vụ như tìm kiếm toàn văn, lập chỉ mục và lọc metadata. Thông qua RESTful API, Lucene MCP Server cho phép client thực hiện upsert (thêm/cập nhật), xóa, liệt kê và truy vấn tài liệu bằng cú pháp truy vấn mạnh mẽ của Lucene. Được xây dựng trên Spring Boot, máy chủ dễ dàng triển khai và có thể đóng gói container với Docker. Đây là giải pháp lý tưởng để tích hợp tính năng tìm kiếm và quản lý tài liệu nâng cao vào quy trình AI hoặc pipeline phát triển phần mềm.

Danh sách Prompt

Không có thông tin về prompt template trong repository.

Danh sách Resource

Không có MCP resource rõ ràng nào được mô tả trong repository.

Danh sách công cụ

• Công cụ Upsert

  • Cho phép client thêm hoặc cập nhật tài liệu trong chỉ mục Lucene qua endpoint /mcp/v1/upsert.

• Công cụ Delete

  • Cho phép xóa tài liệu khỏi chỉ mục Lucene bằng endpoint /mcp/v1/delete.

• Công cụ List

  • Lấy danh sách tài liệu từ chỉ mục qua endpoint /mcp/v1/list.

• Công cụ Query

  • Hỗ trợ truy vấn tìm kiếm phức tạp với cú pháp Lucene qua endpoint /mcp/v1/query.

• Công cụ Status

  • Kiểm tra trạng thái máy chủ với endpoint /mcp/v1/status.

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

• Tìm kiếm tài liệu doanh nghiệp
  Lập trình viên có thể tích hợp Lucene MCP Server để cung cấp khả năng tìm kiếm mạnh mẽ, mở rộng cho tập tài liệu doanh nghiệp lớn, giúp dễ dàng tìm các file và bản ghi liên quan.

• Mở rộng kho tri thức
  Nâng cao trợ lý AI bằng cách cho phép truy vấn và lấy thông tin từ các tài liệu nội bộ như sách hướng dẫn, FAQ hoặc ticket hỗ trợ đã được lập chỉ mục.

• Tự động lấy dữ liệu và lập chỉ mục
  Tự động hóa quy trình bằng cách upsert và cập nhật tài liệu vào chỉ mục Lucene bằng lập trình, đảm bảo bộ máy tìm kiếm luôn được cập nhật.

• Lọc dựa trên metadata
  Tận dụng khả năng lọc truy vấn dựa trên metadata tài liệu của Lucene, hỗ trợ các kịch bản truy xuất dữ liệu nâng cao.

• Tích hợp tìm kiếm qua API
  Cung cấp các tính năng tìm kiếm và quản lý tài liệu cho ứng dụng hoặc agent khác thông qua RESTful endpoint.

Hướng dẫn thiết lập

Windsurf

1. Đảm bảo đã cài đặt Java 11+ và Maven 3.6+.
2. Build dự án:

   mvn clean install
   

3. Thêm Lucene MCP Server vào cấu hình của bạn:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động Windsurf.
5. Kiểm tra máy chủ đang chạy tại http://localhost:8080/mcp/v1/status.

Claude

1. Cài đặt Java 11+ và Maven 3.6+.
2. Build dự án:

   mvn clean install
   

3. Chỉnh sửa cấu hình Claude để thêm:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Khởi động lại Claude và đảm bảo MCP Lucene Server có thể truy cập được.

Cursor

1. Xác nhận đã cài Java 11+ và Maven 3.6+.
2. Build Lucene MCP Server:

   mvn clean install
   

3. Thêm vào cấu hình Cursor của bạn:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Lưu và khởi động lại Cursor.
5. Kiểm tra endpoint tại http://localhost:8080/mcp/v1/status.

Cline

1. Đảm bảo đã cài Java 11+ và Maven 3.6+.
2. Build:

   mvn clean install
   

3. Trong cấu hình Cline của bạn:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Khởi động lại Cline và xác nhận máy chủ MCP đang hoạt động.

Lưu ý về bảo mật API key

Nếu cấu hình của bạn cần bảo mật các API key hoặc thông tin nhạy cảm, hãy sử dụng biến môi trường:

{
  "mcpServers": {
    "lucene-mcp": {
      "command": "java",
      "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"],
      "env": {
        "LUCENE_API_KEY": "${LUCENE_API_KEY}"
      },
      "inputs": {
        "apiKey": "${LUCENE_API_KEY}"
      }
    }
  }
}

Cách sử dụng MCP này trong luồng

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt của bạn, 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 MCP hệ thống, nhập thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "lucene-mcp": {
    "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. Hãy nhớ thay “lucene-mcp” bằng tên thực tế của máy chủ MCP và thay URL bằng địa chỉ MCP server của bạn.

Tổng quan

Dựa trên thông tin hiện có, MCP Lucene Server cung cấp nền tảng vững chắc cho tìm kiếm và quản lý tài liệu nhưng thiếu hỗ trợ rõ ràng cho prompt template, resource, roots hoặc sampling. Máy chủ được tài liệu hóa tốt cho việc cài đặt và sử dụng như một MCP server.

Đánh giá của chúng tôi

MCP Lucene Server là một triển khai MCP mạnh mẽ, thực tiễn dành cho tìm kiếm và quản lý tài liệu cấp doanh nghiệp. Tuy nhiên, việc thiếu prompt template, resource và các tính năng MCP nâng cao như roots hoặc sampling khiến nó ít linh hoạt hơn cho các workflow tác vụ phức tạp. Tổng thể, đây là lựa chọn tốt để tích hợp tìm kiếm Lucene vào hệ thống AI. Điểm MCP: 6/10

Điểm MCP