Máy chủ Nocodb MCP

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

Máy chủ Nocodb MCP đóng vai trò cầu nối giữa trợ lý AI và cơ sở dữ liệu Nocodb thông qua Model Context Protocol (MCP). Máy chủ này cho phép các khách hàng được hỗ trợ AI thực hiện các thao tác CRUD (Tạo, Đọc, Cập nhật, Xóa) một cách liền mạch trên các bảng Nocodb, giúp tối ưu quy trình quản lý dữ liệu. Bằng cách cung cấp các chức năng cơ sở dữ liệu thông qua giao diện MCP, nó cho phép LLM và agent AI truy vấn, tạo, cập nhật, xóa bản ghi hoặc cột, thậm chí tải lên tệp để tạo bảng mới. Sự tích hợp này nâng cao năng suất của lập trình viên nhờ tự động hóa và chuẩn hóa quy trình tương tác với cơ sở dữ liệu, giúp xây dựng, kiểm thử và triển khai ứng dụng AI tập trung vào dữ liệu dễ dàng hơn.

Danh sách Prompts

• Get Records: Lấy dữ liệu từ một bảng Nocodb chỉ định.
• Create Record: Thêm dòng mới với giá trị chỉ định vào bảng.
• Update Record: Cập nhật bản ghi hiện có, ví dụ thay đổi giá trị hoặc loại bỏ hậu tố.
• Delete Record: Xóa bản ghi dựa trên tiêu chí như tên trùng khớp.
• Add Column: Thêm cột mới vào bảng hiện có.
• Update Column Values: Đặt giá trị cho toàn bộ dòng của một cột.
• Delete Column: Xóa cột khỏi bảng.
• Create Table from File: Tạo bảng mới từ dữ liệu trong tệp JSON.
• Bulk Create Records: Thêm nhiều bản ghi mới trong một thao tác.
• Bulk Delete Records: Xóa nhiều bản ghi cùng lúc.

Danh sách Tài nguyên

• Nocodb Tables: Truy cập tất cả bảng trong cơ sở dữ liệu Nocodb đã kết nối, cho phép đọc và sử dụng làm ngữ cảnh.
• Table Schema: Metadata về cấu trúc từng bảng, như tên cột và kiểu dữ liệu.
• Uploaded Files: Các tệp JSON (ví dụ: example_upload.json) có thể được xử lý để tạo hoặc cập nhật bảng.
• Bulk Sample Data: Dữ liệu mẫu hàng loạt và ảnh chụp màn hình được cung cấp trong thư mục docs/sample-bulk phục vụ demo và tham khảo.

Danh sách Công cụ

• CRUD Operations: Công cụ cho các chức năng Tạo, Đọc, Cập nhật, Xóa trên bảng và bản ghi (theo mẫu prompt ở trên).
• Upload File: Công cụ xử lý và tải tệp JSON để tạo bảng trong Nocodb.
• Bulk Operations: Công cụ tạo/xóa hàng loạt bản ghi trong bảng.

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

• Quản lý cơ sở dữ liệu: Tự động hóa thao tác CRUD trên bảng Nocodb, đơn giản hóa việc nhập liệu, chỉnh sửa và dọn dẹp dữ liệu cho lập trình viên.
• Di chuyển dữ liệu: Tải lên và xử lý tệp JSON để nhanh chóng nhập hoặc seed dữ liệu vào Nocodb.
• Phát triển lược đồ: Thêm hoặc xóa cột bằng mã, hỗ trợ thay đổi mô hình dữ liệu ứng dụng.
• Thao tác dữ liệu hàng loạt: Xử lý hiệu quả việc tạo/xóa số lượng lớn bản ghi, hữu ích cho kiểm thử hoặc xử lý theo lô.
• Dashboard do AI điều khiển: Cho phép agent AI lấy và xử lý dữ liệu phục vụ báo cáo, phân tích và tích hợp dashboard theo thời gian thực.

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

Windsurf

1. Đảm bảo đã cài Node.js và Nocodb.
2. Xác định tệp cấu hình Windsurf (ví dụ: settings.json).
3. Thêm Nocodb MCP Server với đoạn mã JSON sau:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra máy chủ bằng thao tác cơ sở dữ liệu mẫu.

Claude

1. Cài đặt Node.js và đảm bảo truy cập được Nocodb.
2. Chỉnh sửa tệp cấu hình MCP của nền tảng Claude.
3. Thêm máy chủ với:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Khởi động lại Claude và kiểm tra kết nối.
5. Xác nhận với prompt kiểm thử.

Cursor

1. Chuẩn bị môi trường với Node.js và thông tin đăng nhập Nocodb.
2. Mở phần cài đặt hoặc bảng tích hợp MCP của Cursor.
3. Thêm cấu hình sau:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Lưu và khởi động lại Cursor.
5. Kiểm tra bằng thao tác CRUD.

Cline

1. Thiết lập Node.js và đảm bảo Nocodb đã chạy.
2. Chỉnh sửa cấu hình MCP của Cline.
3. Thêm máy chủ như sau:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Cline.
5. Kiểm tra bằng kết nối tới bảng Nocodb.

Bảo mật API Key

Lưu trữ API key trong biến môi trường để đảm bảo an toàn. Ví dụ:

{
  "env": {
    "NOCODB_API_KEY": "your-nocodb-key"
  },
  "inputs": {
    "api_key": "${NOCODB_API_KEY}"
  }
}

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

Sử dụng MCP trong FlowHunt

Để tích hợp MCP server vào luồng FlowHunt của bạn, hãy bắt đầu bằng cách thêm thành phần MCP vào luồng 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. Tại phần cấu hình hệ thống MCP, thêm chi tiết máy chủ MCP của bạn bằng định dạng JSON dưới đây:

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

Sau khi cấu hình, agent AI của bạn 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. Hãy nhớ thay “nocodb-mcp” thành tên thực tế máy chủ MCP của bạn và thay URL bằng địa chỉ MCP server của bạn.

Tổng quan

Dựa trên tài liệu và cấu trúc hiện có, Nocodb MCP Server cung cấp tích hợp MCP tốt, bộ mẫu prompt rõ ràng, tài nguyên và hướng dẫn thiết lập chi tiết. Tuy nhiên, chưa có tài liệu riêng về Roots hoặc hỗ trợ Sampling, điều này có thể hạn chế tính linh hoạt trong các kịch bản nâng cao. Nhìn chung, đây là một MCP server thực tiễn và được tài liệu hóa tốt cho các quy trình với cơ sở dữ liệu.

Điểm MCP