MCP.so
Sign In

aranet4-mcp-server

@diegobit

Repository

About aranet4-mcp-server

SImple MCP server to manage your aranet4 device and local db.

#aranet4#co2

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

FAQ from aranet4-mcp-server

How does this server differ from the standalone aranet4-archiver?

aranet4-mcp-server includes MCP integration for use with MCP clients. For a pure Python version without MCP logic, see the separate aranet4-archiver project.

What dependencies are required to run aranet4-mcp-server?

The server depends on the Aranet4-Python library. Using uv is recommended; with pip, run pip install . inside the cloned repository.

Where is the measurement data stored?

All data is stored locally in a SQLite database created by the server. No external cloud service is required.

Can I get visualizations from aranet4-mcp-server?

Yes, for MCP clients that support images, you can ask for a plot when querying recent or historical data. The server will generate and display it.

How do I keep the database automatically updated?

You can set up a cron job (any platform) or a LaunchAgent (macOS) to run fetch-job.py periodically. An example plist file is included in the repository.

Frequently asked questions

How does this server differ from the standalone aranet4-archiver?

aranet4-mcp-server includes MCP integration for use with MCP clients. For a pure Python version without MCP logic, see the separate [aranet4-archiver](https://github.com/diegobit/aranet4-archiver) project.

What dependencies are required to run aranet4-mcp-server?

The server depends on the [Aranet4-Python](https://github.com/Anrijs/Aranet4-Python) library. Using `uv` is recommended; with `pip`, run `pip install .` inside the cloned repository.

Where is the measurement data stored?

All data is stored locally in a SQLite database created by the server. No external cloud service is required.

Can I get visualizations from aranet4-mcp-server?

Yes, for MCP clients that support images, you can ask for a plot when querying recent or historical data. The server will generate and display it.

How do I keep the database automatically updated?

You can set up a cron job (any platform) or a LaunchAgent (macOS) to run `fetch-job.py` periodically. An example plist file is included in the repository.

Comments

Basic information

Category

Other

Transports

stdio

Author

diegobit

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K