MotherDuck MCP Server

MotherDuck MCP Server làm gì?

MotherDuck MCP Server là một triển khai của Model Context Protocol (MCP) kết nối trợ lý AI và IDE với cơ sở dữ liệu DuckDB và MotherDuck. Nó cho phép người dùng thực hiện phân tích SQL mạnh mẽ qua giao diện chuẩn hóa, cho phép truy vấn cả tệp DuckDB cục bộ và cơ sở dữ liệu MotherDuck trên đám mây. Máy chủ hỗ trợ thực thi lai, giúp truy cập dữ liệu liền mạch từ cả lưu trữ cục bộ lẫn đám mây, bao gồm cả Amazon S3 thông qua tích hợp của MotherDuck. Bằng cách cung cấp khả năng tương tác cơ sở dữ liệu dưới dạng công cụ cho hệ thống AI, nó giúp lập trình viên và tác nhân AI dễ dàng thực hiện truy vấn, quản lý dữ liệu và tối ưu hóa quy trình dữ liệu mà không cần cấu hình thủ công hay quản trị máy chủ. Cách tiếp cận serverless này tăng tốc phân tích, chia sẻ dữ liệu và phát triển pipeline dữ liệu trực tiếp từ môi trường hỗ trợ AI.

Danh sách Prompt

• duckdb-motherduck-initial-prompt: Mẫu prompt khởi tạo kết nối với DuckDB hoặc MotherDuck và bắt đầu làm việc với cơ sở dữ liệu.

Danh sách tài nguyên

• Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (Blogpost): Bài blog hướng dẫn tích hợp MCP, DuckDB và AI để phát triển pipeline dữ liệu nhanh chóng.
• Faster Data Pipelines development with MCP and DuckDB (YouTube): Video hướng dẫn sử dụng MCP và DuckDB cho pipeline dữ liệu.

Danh sách công cụ

• query: Thực thi truy vấn SQL trên cơ sở dữ liệu DuckDB hoặc MotherDuck.
  • Tham số đầu vào:
    • query (string, bắt buộc): Câu truy vấn SQL cần thực thi.

Trường hợp sử dụng MCP Server này

• Phân tích SQL trong trợ lý AI: Cho phép LLM hoặc trợ lý lập trình chạy truy vấn SQL trực tiếp lên DuckDB hoặc MotherDuck, biến chỉ dẫn ngôn ngữ tự nhiên thành phân tích dữ liệu thực tiễn.
• Phát triển pipeline dữ liệu: Đẩy nhanh quá trình phát triển và thử nghiệm pipeline dữ liệu khi hệ thống AI có thể tương tác với cả nguồn dữ liệu cục bộ và đám mây.
• Truy vấn lai cục bộ & đám mây: Hỗ trợ các trường hợp cần truy vấn dữ liệu cả tại chỗ (DuckDB) lẫn trên đám mây (MotherDuck), tăng sự linh hoạt cho quy trình làm việc.
• Tích hợp lưu trữ đám mây: Tác nhân AI có thể truy cập và phân tích dữ liệu lưu trữ trên Amazon S3 hoặc dịch vụ đám mây tích hợp thông qua kết nối MotherDuck.
• Khám phá dữ liệu serverless: Loại bỏ nhu cầu quản lý hạ tầng tính toán, cho phép phân tích dữ liệu nhanh, theo nhu cầu cho người dùng và hệ thống AI.

Hướng dẫn cài đặt

Windsurf

1. Đảm bảo bạn đã cài đặt Node.js và Windsurf.

2. Mở tệp cấu hình Windsurf của bạn (thường là windsurf.config.json).

3. Thêm MotherDuck MCP Server vào phần mcpServers:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.

5. Kiểm tra trong Windsurf xem MotherDuck MCP Server đã chạy và truy cập được chưa.

Bảo mật API Key

Sử dụng biến môi trường để cung cấp thông tin nhạy cảm như token MotherDuck:

{
  "mcpServers": {
    "motherduck": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"],
      "env": {
        "motherduck_token": "${MOTHERDUCK_TOKEN}"
      }
    }
  }
}

Claude

1. Cài đặt Claude và đảm bảo Node.js đã sẵn sàng.

2. Tìm tệp cấu hình Claude (thường là claude.config.json).

3. Thêm đoạn sau vào mcpServers của bạn:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Khởi động lại Claude và xác nhận máy chủ đã xuất hiện trên giao diện.

5. Dùng biến môi trường như hướng dẫn trên để bảo mật API Key.

Cursor

1. Đảm bảo bạn đã cài đặt và cập nhật Cursor.

2. Mở phần thiết lập Cursor (cursor.config.json).

3. Thêm vào dưới phần mcpServers:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Lưu và khởi động lại Cursor.

5. Thiết lập token nhạy cảm qua biến môi trường.

Cline

1. Cài đặt Cline và các phụ thuộc cần thiết.

2. Sửa cline.config.json để thêm:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

3. Lưu cấu hình và khởi động lại Cline.

4. Đảm bảo motherduck_token được đặt dưới dạng biến môi trường để bảo mật.

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

Sử dụng MCP trong FlowHunt

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

Nhấn 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, thêm chi tiết MCP server của bạn theo định dạng JSON sau:

{
  "motherduck": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Khi đã cấu hình, tác nhân AI 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 truy cập. Hãy nhớ đổi "motherduck" thành tên thật của MCP server bạn dùng và thay URL bằng URL MCP server của bạn.

Tổng quan

Qua hai bảng trên, MotherDuck MCP Server được tài liệu hóa rõ ràng với prompt, công cụ, tài nguyên và hướng dẫn bảo mật, chỉ thiếu đề cập cụ thể về Roots và hỗ trợ Sampling. Tổng thể, đây là một giải pháp thực tiễn, chắc chắn cho phân tích cơ sở dữ liệu với giao diện MCP.

Điểm MCP