by diegobit
aranet4-mcp-server is a Multi-Client Protocol (MCP) server for managing your Aranet4 CO2 sensor. It fetches, stores, and allows querying of historical CO2 data, integrating seamlessly with MCP clients for enhanced monitoring and analysis.
aranet4-mcp-server is a simple MCP (Multi-Client Protocol) server designed to manage your Aranet4 CO2 sensor. It allows you to fetch data from the device, store it in a local SQLite database, and query historical data. It is built upon the Aranet4-Python
library.
git clone git@github.com:diegobit/aranet4-mcp-server.git
and navigate into the directory.uv
(recommended) or pip install .
.src/server.py
script, providing the correct path to uv
and the project directory.init aranet4
in your client, or manually edit config.yaml
with your device's MAC address and name.fetch-job.py
.fetch_new_data
to update the local database.get_recent_data
and get_data_by_timerange
to retrieve data from the local database, with an option to generate plots.aranet4-archiver
.uv
.~/Library/Application Support/Claude/claude_desktop_config.json
; for Cursor (macOS): ~/.cursor/mcp.json
.aranetctl --scan
from Aranet4-Python
.com.diegobit.aranet4-fetch.plist
to ~/Library/LaunchAgents/
and load it with launchctl load
.config.yaml
.MCP server to manage your Aranet4 CO2 sensor. Built upon Aranet4-Python.
[!TIP] For the standalone python version without MCP logic, see aranet4-archiver.
init aranet4
in your client to set up everything for the mcp server to work with your device.Clone repo:
git clone git@github.com:diegobit/aranet4-mcp-server.git`
cd aranet4-mcp-server
Prepare environment:
pyproject.toml
handles dependencied and virtual environments.pip install .
Add to MCP client configuration:
"aranet4": {
"command": "{{PATH_TO_UV}}", // run `which uv`
"args": [
"--directory",
"{{PATH_TO_SRC}}/aranet4-mcp-server/",
"run",
"src/server.py"
]
}
~/Library/Application Support/Claude/claude_desktop_config.json
~/.cursor/mcp.json
Configure:
init aranet4
to get a guided configuration.config.yaml
. You need to provide the mac address and the device name. You can get the mac address with aranetctl --scan
from Aranet4-Python (installed with this repo dependencies).Dockerfile is available. Remember to pass env variables or update config.yaml
.
Configuration and utils:
init_aranet4_config
: assisted configuration of device.scan_devices
: scan nearby bluetooth aranet4 devices.get_configuration_and_db_stats
: get current config.yaml and general stats from the local sqlite3 db.set_configuration
: set values in config.yaml.To update historical data:
fetch_new_data
: fetch new data from configured nearby aranet4 device and save to local db.To query historical data:
get_recent_data
: get recent data from local db. Can specify how many measurements.
get_data_by_timerange
: get data in specific timerange from local db. Can specify how many measurements (careful, if the range is big and the limit is low, datapoints will be skipped).
For both, ask to receive a plot to have it generated and displayed.
If you want your local db to always be updated, you can setup a cronjob or a launch agent that fetches data automatically every few hours. In MacOS, do as follows:
com.diegobit.aranet4-fetch.plist
.cp com.diegobit.aranet4-fetch.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.diegobit.aranet4-fetch.plist
For other platforms, just run fetch-job.py
periodically however you prefer.
Please log in to share your review and rating for this MCP.
Discover more MCP servers with similar functionality and use cases
by netdata
Real-time, per‑second infrastructure monitoring platform that provides instant insights, auto‑discovery, edge‑based machine‑learning anomaly detection, and lightweight visualizations without requiring complex configuration.
by Arize-ai
Arize Phoenix is an open-source AI and LLM observability tool for inspecting traces, managing prompts, curating datasets, and running experiments.
by msgbyte
Provides website analytics, uptime monitoring, and server status in a single self‑hosted application.
by grafana
Provides programmatic access to Grafana dashboards, datasources, alerts, incidents, and related operational data through a Model Context Protocol server, enabling AI assistants and automation tools to query and manipulate Grafana resources.
by dynatrace-oss
Provides a local server that enables real‑time interaction with the Dynatrace observability platform, exposing tools for problem retrieval, DQL execution, Slack notifications, workflow automation, and AI‑assisted troubleshooting.
by pydantic
Provides tools to retrieve, query, and visualize OpenTelemetry traces and metrics from Pydantic Logfire via a Model Context Protocol server.
by VictoriaMetrics-Community
Access VictoriaMetrics instances through Model Context Protocol, enabling AI assistants and tools to query metrics, explore labels, debug configurations, and retrieve documentation without leaving the conversational interface.
by axiomhq
Axiom MCP Server implements the Model Context Protocol (MCP) for Axiom, enabling AI agents to query logs, traces, and other event data using the Axiom Processing Language (APL). It allows AI agents to perform monitoring, observability, and natural language analysis of data for debugging and incident response.
by GeLi2001
Datadog MCP Server is a Model Context Protocol (MCP) server that interacts with the official Datadog API. It enables users to access and manage various Datadog functionalities, including monitoring, dashboards, metrics, events, logs, and incidents.