Máy chủ ArangoDB MCP

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

Máy chủ ArangoDB MCP là một máy chủ Model Context Protocol (MCP) dựa trên TypeScript, cung cấp khả năng tương tác cơ sở dữ liệu liền mạch với ArangoDB. Đóng vai trò cầu nối mạnh mẽ giữa các trợ lý AI và cơ sở dữ liệu ArangoDB, nó cho phép nhà phát triển và các tác nhân sử dụng LLM thực thi các thao tác cơ sở dữ liệu cốt lõi trực tiếp thông qua các công cụ MCP chuẩn hóa. Máy chủ này cho phép thực hiện các tác vụ như truy vấn dữ liệu, chèn và cập nhật tài liệu, quản lý bộ sưu tập, và sao lưu—all thông qua các lời gọi công cụ đơn giản. Việc tích hợp với các nền tảng như Claude, VSCode (thông qua các extension như Cline), và nhiều hơn nữa, biến nó thành backend đa năng giúp tăng tốc quy trình phát triển cần truy cập dữ liệu có cấu trúc theo thời gian thực hoặc lập trình.

Danh sách Prompt

Không có mẫu prompt cụ thể nào được nhắc đến trong kho lưu trữ.

Danh sách Tài nguyên

Không có tài nguyên MCP rõ ràng nào được mô tả trong tài liệu kho lưu trữ.

Danh sách Công cụ

• arango_query
  Thực thi truy vấn AQL (ArangoDB Query Language). Nhận chuỗi truy vấn và biến bind tùy chọn, trả về kết quả truy vấn dạng JSON.

• arango_insert
  Chèn tài liệu vào bộ sưu tập. Yêu cầu tên bộ sưu tập và đối tượng tài liệu; tự động tạo key nếu không cung cấp.

• arango_update
  Cập nhật tài liệu đã có trong bộ sưu tập. Yêu cầu tên bộ sưu tập, key tài liệu và đối tượng cập nhật.

• arango_remove
  Xóa tài liệu khỏi bộ sưu tập. Yêu cầu tên bộ sưu tập và key tài liệu.

• arango_backup
  Sao lưu tất cả bộ sưu tập ra các tệp JSON trong thư mục chỉ định, hữu ích cho di chuyển và sao lưu dữ liệu.

• arango_list_collections
  Liệt kê tất cả bộ sưu tập trong cơ sở dữ liệu, trả về tên, ID và loại.

• arango_create_collection
  Tạo bộ sưu tập mới (dạng document hoặc edge), với tuỳ chọn tên, loại và chế độ đồng bộ.

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

• Quản lý cơ sở dữ liệu
  Thực hiện thao tác CRUD (tạo, đọc, cập nhật, xoá) trên các bộ sưu tập ArangoDB trực tiếp từ công cụ AI hoặc tác nhân chat.

• Khám phá codebase cho dự án hướng dữ liệu
  Cho phép developer truy vấn và chỉnh sửa dữ liệu ứng dụng mà không cần rời môi trường phát triển, giúp quá trình khám phá dữ liệu mượt mà hơn.

• Sao lưu và di chuyển dữ liệu tự động
  Sử dụng công cụ sao lưu để xuất dữ liệu bộ sưu tập dưới dạng JSON, hỗ trợ quy trình sao lưu tự động và di chuyển dữ liệu.

• Tích hợp với tác nhân AI
  Trao quyền cho LLMs và trợ lý AI (như Claude hoặc trong VSCode qua Cline) truy xuất, cập nhật hoặc phân tích dữ liệu cơ sở dữ liệu như một phần của quy trình tác nhân.

• Quản lý bộ sưu tập linh hoạt
  Cho phép lập trình tạo mới và liệt kê bộ sưu tập, hỗ trợ tạo mẫu nhanh hoặc ứng dụng đa tenant.

Cách thiết lập

Windsurf

Không có hướng dẫn thiết lập cho Windsurf.

Claude

Không có hướng dẫn thiết lập cho Claude.

Cursor

Không có hướng dẫn thiết lập cho Cursor.

Cline (tiện ích mở rộng VSCode)

1. Yêu cầu: Đảm bảo bạn đã cài đặt VSCode (phiên bản 1.99.0 trở lên).
2. Chỉnh sửa/Tạo cấu hình MCP:
   • Workspace: .vscode/mcp.json
   • User: Thêm vào cài đặt người dùng VSCode để sử dụng toàn cục.
3. Thêm cấu hình máy chủ ArangoDB MCP:

   {
     "servers": {
       "arango-mcp": {
         "type": "stdio",
         "command": "npx",
         "args": ["arango-server"],
         "env": {
           "ARANGO_URL": "http://localhost:8529",
           "ARANGO_DB": "v20",
           "ARANGO_USERNAME": "app",
           "ARANGO_PASSWORD": "75Sab@MYa3Dj8Fc"
         }
       }
     }
   }
   

4. Khởi động máy chủ MCP:
   • Mở Command Palette (Ctrl+Shift+P hoặc Cmd+Shift+P trên Mac)
   • Chạy MCP: Start Server và chọn arango-mcp.

Bảo mật API Keys

Nên sử dụng biến môi trường cho thông tin xác thực. Ví dụ:

{
  "servers": {
    "arango-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["arango-server"],
      "env": {
        "ARANGO_URL": "${env:ARANGO_URL}",
        "ARANGO_DB": "${env:ARANGO_DB}",
        "ARANGO_USERNAME": "${env:ARANGO_USERNAME}",
        "ARANGO_PASSWORD": "${env:ARANGO_PASSWORD}"
      }
    }
  }
}

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

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 thêm thành phần MCP vào flow và kết nối nó với tác nhân 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, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

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

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

Tổng quan

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

Máy chủ MCP này được tài liệu hóa tốt về hỗ trợ công cụ và thiết lập, đặc biệt cho VSCode/Cline. Tuy nhiên, nó thiếu các mẫu prompt và mô tả tài nguyên rõ ràng, cũng không nhắc đến sampling hoặc hỗ trợ roots. Thế mạnh lớn nhất là bộ công cụ cơ sở dữ liệu toàn diện và hướng dẫn sử dụng biến môi trường rõ ràng.
Tổng thể, chúng tôi đánh giá máy chủ MCP này 7/10 về tính thực tiễn và tài liệu, nhưng thiếu một số tính năng MCP nâng cao.

Điểm MCP