Máy chủ Apache IoTDB MCP

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

Apache IoTDB MCP Server là một triển khai của Giao thức Ngữ cảnh Mô hình (MCP), cung cấp khả năng tương tác cơ sở dữ liệu và trí tuệ doanh nghiệp liền mạch thông qua IoTDB – một cơ sở dữ liệu chuỗi thời gian. Máy chủ này đóng vai trò cầu nối, cho phép trợ lý AI và các client thực thi truy vấn SQL trên IoTDB, hỗ trợ các tác vụ phân tích và quản lý dữ liệu trực tiếp bằng ngôn ngữ tự nhiên hoặc luồng làm việc do LLM điều khiển. Các nhà phát triển có thể sử dụng máy chủ MCP để truy vấn dữ liệu, xem thông tin lược đồ và lấy metadata, tăng cường khả năng tích hợp IoTDB vào môi trường phát triển sử dụng AI cho các tác vụ như truy vấn dữ liệu chuỗi thời gian và quản lý lược đồ cơ sở dữ liệu.

Danh sách Prompts

Máy chủ không cung cấp prompt nào.

Danh sách Resources

Máy chủ không mở ra tài nguyên nào.

Danh sách Tools

IoTDB MCP Server cung cấp các công cụ khác nhau tùy vào SQL dialect (“tree” hoặc “table”) được chọn.

Tree Model

• metadata_query
  • Thực thi truy vấn SHOW/COUNT để lấy metadata từ cơ sở dữ liệu IoTDB.
  • Input: query_sql (string) – Câu lệnh SQL SHOW/COUNT cần thực thi.
  • Output: Kết quả truy vấn dạng mảng các object.
• select_query
  • Thực thi truy vấn SELECT để đọc dữ liệu chuỗi thời gian từ cơ sở dữ liệu.
  • Input: query_sql (string) – Câu lệnh SQL SELECT cần thực thi.
  • Output: Kết quả truy vấn dạng mảng các object.

Table Model

Công cụ truy vấn

• read_query
  • Thực thi truy vấn SELECT để đọc dữ liệu từ cơ sở dữ liệu.
  • Input: query (string) – Câu lệnh SQL SELECT cần thực thi.
  • Output: Kết quả truy vấn dạng mảng các object.

Công cụ lược đồ

• list_tables
  • Lấy danh sách tất cả các bảng trong cơ sở dữ liệu.
  • Input: Không có.
  • Output: Mảng tên bảng.
• describe-table
  • Cung cấp thông tin lược đồ cho một bảng cụ thể.
  • Input: table_name (string) – Tên bảng cần mô tả.
  • Output: Mảng các định nghĩa cột với tên và kiểu dữ liệu.

Trường hợp sử dụng máy chủ MCP này

• Quản lý cơ sở dữ liệu chuỗi thời gian
  Dễ dàng truy vấn, duyệt và quản lý dữ liệu chuỗi thời gian quy mô lớn lưu trữ trong IoTDB trực tiếp từ trợ lý AI hoặc công cụ phát triển sử dụng LLM.
• Khám phá lược đồ
  Lấy và khám phá lược đồ cơ sở dữ liệu, nhận danh sách bảng, xem mô tả bảng để hiểu và tài liệu hóa cấu trúc cơ sở dữ liệu.
• Tích hợp trí tuệ doanh nghiệp
  Tích hợp dữ liệu IoTDB vào quy trình BI với truy vấn ngôn ngữ tự nhiên và phân tích lược đồ, hỗ trợ phân tích và báo cáo.
• Phân tích dữ liệu tự động
  Sử dụng máy chủ MCP như backend cho pipeline phân tích dữ liệu tự động, nơi LLM tạo và chạy truy vấn SQL dựa trên ý định người dùng.
• Kiểm tra metadata
  Thực thi truy vấn SHOW/COUNT để xem metadata cơ sở dữ liệu, hỗ trợ giám sát, kiểm tra và tối ưu hóa cơ sở dữ liệu.

Cách thiết lập

Windsurf

1. Đảm bảo bạn đã cài đặt Python và trình quản lý gói uv.
2. Cài đặt hoặc clone kho máy chủ IoTDB MCP.
3. Chỉnh sửa file cấu hình Windsurf để thêm máy chủ IoTDB MCP.
4. Sử dụng đoạn JSON sau trong cấu hình:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Lưu cấu hình và khởi động lại Windsurf.
6. Kiểm tra máy chủ đã chạy và kết nối thành công.

Claude

1. Cài đặt Python, uv và IoTDB.
2. Clone kho máy chủ IoTDB MCP.
3. Trên MacOS, sửa file ~/Library/Application Support/Claude/claude_desktop_config.json; trên Windows, sửa %APPDATA%/Claude/claude_desktop_config.json.
4. Thêm entry máy chủ MCP:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Lưu thay đổi và khởi động lại Claude Desktop.
6. Xác nhận máy chủ đã khả dụng trong Claude.

Cursor

1. Đảm bảo đã cài đặt Python, uv và IoTDB.
2. Clone kho máy chủ MCP.
3. Chỉnh sửa cấu hình Cursor để thêm máy chủ MCP.
4. Sử dụng JSON như sau:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Lưu cấu hình và khởi động lại Cursor.
6. Đảm bảo máy chủ MCP đã hoạt động và phản hồi.

Cline

1. Cài đặt các phụ thuộc cần thiết: Python, uv và IoTDB.
2. Clone Apache IoTDB MCP Server.
3. Mở file cấu hình của Cline.
4. Thêm thông tin máy chủ MCP như sau:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. Lưu và khởi động lại Cline.
6. Kiểm tra tích hợp máy chủ MCP.

Bảo mật API Key
Thông tin xác thực như IOTDB_USER và IOTDB_PASSWORD được quản lý qua trường env trong cấu hình. Sử dụng biến môi trường để tránh ghi cứng dữ liệu nhạy cảm. Ví dụ:

"env": {
  "IOTDB_HOST": "127.0.0.1",
  "IOTDB_PORT": "6667",
  "IOTDB_USER": "${IOTDB_USER}",
  "IOTDB_PASSWORD": "${IOTDB_PASSWORD}",
  "IOTDB_DATABASE": "test"
}

Và thiết lập các biến môi trường này trong hệ thống trước khi khởi động máy chủ.

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, 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 AI agent 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 hệ thống MCP, nhập thông tin máy chủ MCP của bạn theo định dạng JSON sau:

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

Sau khi cấu hình, AI agent sẽ có thể sử dụng MCP này như một công cụ với đầy đủ các chức năng. Hãy nhớ đổi “iotdb” thành tên thực tế của máy chủ MCP và thay URL bằng URL máy chủ của bạn.

Tổng quan

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

Máy chủ IoTDB MCP là một triển khai tối giản, tập trung vào các công cụ tương tác cơ sở dữ liệu thiết yếu cho IoTDB. Nó thiếu các tính năng MCP nâng cao như prompts, resources, roots và sampling, nhưng rất phù hợp cho trường hợp sử dụng truy cập cơ sở dữ liệu chuỗi thời gian. Tài liệu cài đặt cho Claude Desktop rõ ràng; các tích hợp khác cũng chuẩn. Tổng thể, đây là một máy chủ MCP chuyên biệt nhưng chắc chắn cho các workflow tập trung vào cơ sở dữ liệu.

MCP Score