aranet4-mcp-server

aranet4-mcp-server

3

The aranet4-mcp-server is an MCP server designed to manage the Aranet4 CO2 sensor, allowing data collection and configuration via an AI-assisted setup. It offers features such as remote querying of historical data and automatic data fetching through cron jobs or similar methods.

aranet4-mcp-server

MCP server to manage your Aranet4 CO2 sensor. Built upon the Aranet4-Python library.

Features:

  • Scan for nearby devices.
  • Fetch new data from the device and save it locally.
  • Ask questions about recent or past data measurements.
  • Assisted configuration is available for easy setup.

Installation

  1. Clone the repository and navigate to the directory.
  2. Prepare the environment using uv or pip.
  3. Add the server to your MCP client configuration.
  4. Configure using either AI-assisted or manual methods.

Dockerfile

A Dockerfile is available. Pass environment variables or update the config.yaml.

List of tools

  • init_aranet4_config: Assisted configuration.
  • scan_devices: Scan nearby bluetooth devices.
  • fetch_new_data: Fetch and save new data from the device.
  • get_recent_data, get_data_by_timerange: Query historical data.

Automatic data fetch job

Configure a job to automatically update the local database with new data from the device.