Aranet4

MCP server that scans for Aranet4 devices, fetches data into a local DB, and supports querying and plotting of measurements.

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "diegobit-aranet4-mcp-server": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}/aranet4-mcp-server/",
        "run",
        "src/server.py"
      ]
    }
  }
}

You run an MCP server to manage your Aranet4 CO2 sensor. This server scans for nearby Aranet4 devices, fetches new measurements into a local database, and lets you query recent or historical data. It also supports optional plotting for visual analysis and offers assisted setup so you can connect your device quickly.

How to use

After you set up the server, you interact with it from an MCP client. Use the assisted configuration to connect your Aranet4 with a single command. Once connected, you can fetch new data from the device memory, review recent measurements, and query data by time range. If your client supports it, you can request plots to visualize data alongside the raw results.

How to install

Prerequisites: you need Python and an MCP runner. The server relies on the Aranet4-Python package and a local environment configured for MCP usage.

Clone the repository and open the project directory.
Prepare the environment. You have two options:

Recommended (with uvx): Nothing to do. The provided configuration handles dependencies and virtual environments.
Alternative (with pip): Install locally using pip.

git clone git@github.com:diegobit/aranet4-mcp-server.git
cd aranet4-mcp-server
# Option A: use the project-managed environment
# (follow the project's pyproject.toml to create a venv)
# Option B: install via pip in-place
pip install .

Configure and run

Add the server to your MCP client configuration. Use the following MCP command path to run the server from your MCP client. This enables the client to start the Aranet4 MCP server within your environment.

"aranet4": {
  "command": "{{PATH_TO_UV}}", // run `which uv`
  "args": [
    "--directory",
    "{{PATH_TO_SRC}}/aranet4-mcp-server/",
    "run",
    "src/server.py"
  ]
}

Important notes

The config above uses UV to execute the server from its source directory. You can adjust the path placeholders to point to your actual installation locations.

Available tools

init_aranet4_config

Assisted configuration of the Aranet4 MCP server to connect your device.

scan_devices

Scan nearby Aranet4 devices over BLE to identify available sensors.

get_configuration_and_db_stats

Retrieve current config.yaml settings and general statistics from the local sqlite3 database.

set_configuration

Update values in config.yaml to reflect changes in device or server behavior.

fetch_new_data

Fetch newly recorded data from the configured Aranet4 device and save it to the local database.

get_recent_data

Query recent measurements from the local database, with optional limits on how many results to return.

get_data_by_timerange

Query data within a specific time range from the local database, with optional limits on data points.