Máy chủ aranet4 MCP

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

Máy chủ aranet4 MCP là một máy chủ Model Context Protocol (MCP) được thiết kế để quản lý thiết bị cảm biến CO2 Aranet4 của bạn cùng cơ sở dữ liệu cục bộ liên quan. Bằng cách kết nối các trợ lý AI và nguồn dữ liệu bên ngoài, máy chủ này cho phép tương tác liền mạch với thiết bị cho các tác vụ như quét thiết bị lân cận, lấy và lưu trữ dữ liệu đo lường, và truy vấn các bản ghi đo cảm biến lịch sử. Nó hỗ trợ cập nhật tự động, cấu hình có hướng dẫn, thậm chí trực quan hóa dữ liệu cho các ứng dụng khách hỗ trợ hình ảnh. Máy chủ này nâng cao luồng công việc của nhà phát triển bằng cách đơn giản hóa việc tích hợp dữ liệu cảm biến môi trường vào các quy trình tự động hóa dựa trên LLM, giúp dễ dàng giám sát chất lượng không khí, theo dõi xu hướng lịch sử và quản lý cài đặt thiết bị một cách lập trình.

Danh sách Prompt

Không có mẫu prompt rõ ràng nào được ghi lại trong kho hoặc README.

Danh sách Tài nguyên

Không có tài nguyên rõ ràng nào được ghi lại trong kho hoặc README.

Danh sách Công cụ

Cấu hình và Tiện ích:

• init_aranet4_config: Hỗ trợ cấu hình thiết bị Aranet4.
• scan_devices: Quét các thiết bị Aranet4 Bluetooth lân cận.
• get_configuration_and_db_stats: Lấy config.yaml hiện tại và thống kê tổng thể từ cơ sở dữ liệu SQLite cục bộ.
• set_configuration: Đặt giá trị trong config.yaml.

Để cập nhật dữ liệu lịch sử:

• fetch_new_data: Lấy dữ liệu mới từ thiết bị Aranet4 đã cấu hình và lưu vào cơ sở dữ liệu cục bộ.

Để truy vấn dữ liệu lịch sử:

• get_recent_data: Lấy dữ liệu mới nhất từ cơ sở dữ liệu cục bộ; có thể chỉ định số lượng phép đo.

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

• Giám sát môi trường: Tự động quét và lấy dữ liệu chất lượng không khí, CO2 từ các thiết bị Aranet4 lân cận, lưu trữ vào cơ sở dữ liệu cục bộ để phân tích thêm.
• Phân tích dữ liệu lịch sử: Truy vấn và xem lại các bản ghi cảm biến trong quá khứ để nhận biết xu hướng hoặc bất thường về chất lượng không khí theo thời gian, hữu ích cho nhà nghiên cứu hoặc quản lý cơ sở.
• Cấu hình tự động: Sử dụng công cụ AI hoặc thủ công để nhanh chóng thiết lập và cấu hình thiết bị Aranet4, giảm thời gian cài đặt cho người dùng không chuyên.
• Trực quan hóa & Báo cáo: Với các ứng dụng khách hỗ trợ xuất hình ảnh, tạo và trực quan hóa các biểu đồ của các phép đo gần đây để dễ dàng hiểu và báo cáo.
• Quản lý đội thiết bị: Quét và quản lý nhiều thiết bị Aranet4 trong một không gian, cho phép giám sát và cấu hình tập trung.

Cách thiết lập

Windsurf

1. Yêu cầu cơ bản: Đảm bảo bạn đã cài đặt Node.js và Python.
2. Sao chép và thiết lập máy chủ:

   git clone git@github.com:diegobit/aranet4-mcp-server.git
   cd aranet4-mcp-server
   

3. Cài đặt phụ thuộc: Dùng uv hoặc pip install . tùy ý.
4. Chỉnh sửa cấu hình Windsurf: Thêm máy chủ aranet4 vào phần mcpServers.
5. Lưu và khởi động lại Windsurf.
6. Xác minh: Kiểm tra xem thiết bị của bạn đã được phát hiện và dữ liệu có truy cập được không.

Ví dụ JSON:

"mcpServers": {
  "aranet4": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/aranet4-mcp-server/",
      "run",
      "src/server.py"
    ]
  }
}

Lưu ý: Để bảo mật khóa API hoặc thông tin nhạy cảm, hãy sử dụng biến môi trường:

"aranet4": {
  "env": {
    "ARANET4_API_KEY": "your_api_key_here"
  },
  "inputs": {}
}

Claude

1. Làm theo các bước 1–3 phía trên.
2. Chỉnh sửa file cấu hình Claude Desktop: Tại ~/Library/Application Support/Claude/claude_desktop_config.json.
3. Thêm máy chủ aranet4 như trên.
4. Lưu và khởi động lại Claude Desktop.
5. Sử dụng init aranet4 để thiết lập có hướng dẫn.

Cursor

1. Làm theo các bước 1–3 phía trên.
2. Chỉnh sửa file cấu hình Cursor: Tại ~/.cursor/mcp.json.
3. Thêm cấu hình JSON máy chủ aranet4.
4. Lưu và khởi động lại Cursor.
5. Sử dụng init aranet4 để thiết lập có hướng dẫn.

Cline

1. Làm theo các bước 1–3 phía trên.
2. Chỉnh sửa file cấu hình Cline phù hợp.
3. Thêm cấu hình JSON máy chủ aranet4.
4. Lưu và khởi động lại Cline.
5. Sử dụng công cụ cấu hình tương tác để thiết lập.

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

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

Sau khi cấu hình, agent AI có thể sử dụng MCP này như một công cụ với quyền truy cập đầy đủ chức năng. Đừng quên thay “aranet4” bằng tên thực của máy chủ MCP của bạn và thay URL bằng địa chỉ MCP của bạn.

Tổng quan

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

Máy chủ aranet4 MCP mang lại giá trị lớn cho quản lý thiết bị Aranet4 và cảm biến môi trường, với khả năng cung cấp công cụ rõ ràng và hỗ trợ đa nền tảng tốt. Tuy nhiên, nó thiếu các mẫu prompt được ghi lại và tài nguyên MCP rõ ràng, cũng như các tính năng MCP nâng cao như sampling và roots. Hướng dẫn cài đặt thực tế và chi tiết, đặc biệt cho các công cụ phát triển AI phổ biến. Tổng thể, đây là một triển khai MCP thực dụng, chắc chắn cho lĩnh vực của nó.

Điểm MCP

Đánh giá: 6/10 – Công cụ thiết bị chuyên dụng tuyệt vời, nhưng thiếu các tính năng MCP mở rộng và tài liệu về prompt/tài nguyên.