Aranet4 MCP Server

🚀 aranet4-mcp-server

aranet4-mcp-server是一個用於管理Aranet4二氧化碳傳感器的MCP服務器，它基於Aranet4-Python構建，能幫助用戶高效管理傳感器數據。

💡 使用建議

如果需要沒有MCP邏輯的獨立Python版本，請查看aranet4-archiver。

✨ 主要特性

• 設備掃描：可掃描附近的Aranet4設備。
• 數據存儲：從嵌入式設備存儲中獲取新數據，並保存到本地sqlite數據庫，方便跟蹤和後續查看。關於自動更新，可查看後續內容。
• 信息查詢：能查詢近期測量信息或特定過去日期的信息。
• 可視化展示：支持圖像的MCP客戶端可請求將數據顯示為圖表，實現友好的可視化效果！
• 輔助配置：💫 安裝後，只需在客戶端中輸入 init aranet4 即可設置與您的設備一起使用的MCP服務器。

📦 安裝指南

1. 克隆倉庫：

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

2. 準備環境：
   • 推薦方式（使用uv）：無需額外操作，提供的 pyproject.toml 會處理依賴和虛擬環境。
   • 替代方案（使用pip）：使用 pip install . 進行安裝。
3. 添加到MCP客戶端配置：

   "aranet4": {
     "command": "{{PATH_TO_UV}}", // 運行 `which uv`
       "args": [
         "--directory",
         "{{PATH_TO_SRC}}/aranet4-mcp-server/",
         "run",
         "src/server.py"
       ]
   }
   

   • Claude Desktop MacOS配置文件路徑：~/Library/Application Support/Claude/claude_desktop_config.json
   • Cursor MacOS配置文件路徑：~/.cursor/mcp.json
4. 配置：
   • 推薦方式（AI輔助配置！）：啟動客戶端後輸入 init aranet4 以獲得引導式配置。
   • 替代方案（手動）：編輯文件 config.yaml，您需要提供mac地址和設備名稱。可以從Aranet4-Python（隨此倉庫的依賴安裝）中使用 aranetctl --scan 獲取mac地址。

🐳 Dockerfile

項目提供了Dockerfile，您可以傳遞環境變量或更新 config.yaml 來使用。

🛠️ 工具列表

配置和工具

• init_aranet4_config：輔助設備配置。
• scan_devices：掃描附近的藍牙Aranet4設備。
• get_configuration_and_db_stats：獲取當前的 config.yaml 和本地sqlite3數據庫的一般統計信息。
• set_configuration：設置 config.yaml 中的值。

更新歷史數據

• fetch_new_data：從配置的附近Aranet4設備中獲取新數據並保存到本地數據庫。

查詢歷史數據

• get_recent_data：從本地數據庫獲取近期數據，可指定要獲取的測量值數量。
• get_data_by_timerange：在特定時間段內從本地數據庫獲取數據，可指定要獲取的測量值數量（注意，如果時間範圍很大且限制較低，可能會跳過某些數據點）。

對於這兩個查詢工具，都可以請求生成圖表並顯示。

⏰ 自動更新數據的任務

如果您希望本地數據庫始終保持最新狀態，可以設置一個cron作業或launch agent，每隔幾小時自動抓取一次數據。在MacOS中，可按以下步驟操作：

1. 配置 com.diegobit.aranet4-fetch.plist 中的絕對路徑。
2. 安裝LaunchAgent：

   cp com.diegobit.aranet4-fetch.plist ~/Library/LaunchAgents/
   launchctl load ~/Library/LaunchAgents/com.diegobit.aranet4-fetch.plist
   

對於其他平臺，請按自己喜歡的方式定期運行 fetch-job.py。