aranet4-mcp-server

用于管理Aranet4二氧化碳传感器的MCP服务器。基于Aranet4-Python构建。

[!TIP] 如果需要没有MCP逻辑的独立Python版本，请查看aranet4-archiver。

功能

• 扫描附近的设备。
• 从嵌入式设备存储中获取新数据并保存到本地sqlite数据库，以便跟踪和以后查看。有关自动更新，请参见下面。
• 查询 recent measurements 的信息或特定过去日期的信息。
• [支持图像的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 以获得 guided configuration。
   • 替代方案（手动）：编辑文件 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：从本地数据库获取 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。