aranet4 mcp服务器
MCP服务器管理您的Aranet4二氧化碳传感器。建立在 Aranet4 Python.
\[！提示\] 对于没有MCP逻辑的独立python版本，请参阅 aranet4归档器.
特征：
- 扫描附近的设备。
- 从嵌入式设备内存中获取新数据，并保存到本地sqlite数据库中以供跟踪和以后查看。有关自动更新，请参阅底部。
- 询问有关最近测量或特定过去日期的问题。
- *\[适用于支持映像的MCP客户端\]* 要求绘制数据也要有一个很好的可视化效果！
- 辅助配置！ 💫 安装后，只需询问
init aranet4在您的客户端中设置mcp服务器与您的设备配合使用的所有内容。
需求
Aranet4设备已配对。该设备使用BLE，因此不会在常规蓝牙搜索中显示。在MacOS上，一种方法是从App Store安装LightBlue。
安装
- 克隆仓库：
git clone git@github.com:diegobit/aranet4-mcp-server.git`
cd aranet4-mcp-server- 准备环境：
- 推荐（with 紫外线)：没什么可做的 pyproject.toml 处理依赖和虚拟环境。 - 备选方案（带pip）：安装时 pip install .
- 添加到MCP客户端配置：
"aranet4": {
"command": "{{PATH_TO_UV}}", // run `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 - 光标MacOS配置文件路径： ~/.cursor/mcp.json
- 配置：
- 推荐（AI辅助配置！）： 启动你的客户并询问 init aranet4 以获得引导配置。 - 替代方案（手动）： 编辑文件 config.yaml。您需要提供mac地址和设备名称。你可以通过以下方式获取mac地址 aranetctl --scan 从 Aranet4 Python （与此repo依赖项一起安装）。
Dockerfile
Dockerfile可用。记得传递env变量或更新 config.yaml.
工具清单
配置和实用程序:
init_aranet4_config：设备的辅助配置。scan_devices：扫描附近的蓝牙aranet4设备。get_configuration_and_db_stats：从本地sqlite3db获取当前config.yaml和常规统计数据。set_configuration：在config.yaml中设置值。
更新历史数据:
fetch_new_data：从附近配置的aranet4设备获取新数据并保存到本地数据库。
查询历史数据:
get_recent_data：从本地数据库获取最新数据。可以指定测量次数。
get_data_by_timerange：从本地数据库获取特定时间范围内的数据。可以指定测量次数（注意，如果范围大而限制低，则将跳过数据点）。
对于这两种情况，要求接收一个绘图以生成和显示它。
自动数据提取作业
如果您希望本地数据库始终更新，可以设置一个cronjob或启动代理，每隔几个小时自动获取数据。在MacOS中，请执行以下操作：
- 在中配置绝对路径
com.diegobit.aranet4-fetch.plist. - 安装LaunchAgent：
cp com.diegobit.aranet4-fetch.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.diegobit.aranet4-fetch.plist对于其他平台，只需运行 fetch-job.py 定期，无论你喜欢什么。
