aranet4-mcp-server

用于管理 Aranet4 CO2 传感器的 MCP 服务器。构建于 Aranet4-Python 之上。

[!TIP] 对于没有 MCP 逻辑的独立 Python 版本，请参阅 aranet4-archiver。

功能：

• 扫描附近的设备。
• 从嵌入式设备内存中获取新数据，并保存到本地 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",
         "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 地址（与此仓库依赖项一起安装）。

工具列表

配置和实用程序：

• init_aranet4_config：辅助设备配置。
• scan_devices：扫描附近的蓝牙 aranet4 设备。
• get_configuration：获取当前 config.yaml。
• set_configuration：设置 config.yaml 中的值。
• get_database_stats：从本地 sqlite3 数据库获取常规统计信息。

更新历史数据：

• fetch_new_data：从配置的附近 aranet4 设备获取新数据并保存到本地数据库。

查询历史数据：

• get_recent_data：从本地数据库获取最近的数据。可以指定测量次数。

• get_data_by_timerange：从本地数据库获取特定时间范围内的数据。可以指定测量次数（注意，如果范围很大且限制很低，则会跳过数据点）。

  对于两者，请求接收绘图以生成和显示它。

自动数据获取作业

如果您希望您的本地数据库始终保持更新，您可以设置一个 cronjob 或启动代理，每隔几个小时自动获取数据。在 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，无论您喜欢哪种方式。