What is aranet4-mcp-server?
aranet4-mcp-server is an MCP server that manages your Aranet4 CO₂ sensor. It scans nearby devices, fetches new data from the sensor's embedded memory, saves measurements to a local SQLite database, and allows querying recent or historical data—including optional visualizations. Built on the Aranet4-Python library, it is intended for users who want to monitor and track air quality through MCP-compatible clients.
How to use aranet4-mcp-server?
Clone the repository, prepare the environment (recommended with uv, alternative with pip install .), and add the server to your MCP client configuration (e.g., Claude Desktop or Cursor). After installation, start your client and ask init aranet4 for guided configuration, or manually edit config.yaml with the device's MAC address. Use the fetch_new_data tool to update the database, and query data with get_recent_data or get_data_by_timerange. Optionally, set up a cron job or LaunchAgent for automatic periodic fetching.
Key features of aranet4-mcp-server
- Scan for nearby Aranet4 devices via Bluetooth
- Fetch and store measurement history in a local SQLite database
- Query recent data or data within a specific time range
- Generate plots for MCP clients that support images
- Assisted configuration via the
init aranet4 command
Use cases of aranet4-mcp-server
- Continuously monitor CO₂ levels and temperature in a room
- Track air quality trends over days or weeks
- Automate data collection and review historical measurements
- Integrate sensor data into workflows via MCP clients like Claude
评论