Overview
Aranet4 MCP Server manages your Aranet4 CO2 sensor via MCP, enabling local data collection and easy querying. It scans for nearby BLE devices, fetches new measurements from device memory, and stores them in a local SQLite database for history tracking and visualization. Users can ask questions about recent measurements or specific dates, and, for MCP clients that support images, request plotted visualizations. An assisted configuration flow lets you set up the server with init aranet4 after installation, simplifying pairing and parameter setup. The server is built on Aranet4-Python and exposes tools for scanning devices, reading configuration and database stats, updating configuration, and fetching historical data. You can fetch new data periodically to keep the database current, and optionally deploy automatic fetch jobs on macOS (LaunchAgent) or via cron on other platforms. In short, aranet4-mcp-server provides discovery, data ingestion, historical querying, visualization, and guided setup for Aranet4 CO2 sensors in an MCP ecosystem.
Features
Scan for nearby devices
Scan nearby Bluetooth Aranet4 devices to discover targets for data collection.
Fetch new data into local SQLite
Fetch new data from embedded device memory and save to a local SQLite database for tracking and viewing.
Get recent data
Get recent data from the local database; specify how many measurements.
Get data by timerange
Retrieve data within a specific timerange from the local database; beware of skipping datapoints if the range is large and the limit is low.
Data visualization
For MCP clients that support images, request plotted visualizations of the data.
Assisted configuration
Assisted configuration of the device via init aranet4 to set up the MCP server.
Configuration and DB stats tools
Utilities to view current config.yaml and general stats from the local SQLite database, and to update configuration.
Who Is This For?
- Aranet4 users:Fetch and view sensor data; ask questions about recent or historical measurements.
