CO2 Sensor

🚀 MCP Server for Sensor Devices

This project is a Node.js application designed to work with Claude Desktop. It emulates a CO₂ sensor device and provides JSON-RPC services for interacting with the device. The application can run in simulation mode or connect to a Raspberry Pi Pico (via USB) in real mode to read CO₂ concentrations.

🚀 Quick Start

This application is a Node.js program that emulates a CO₂ sensor device. It supports both simulation and real - world data collection from a Raspberry Pi Pico.

✨ Features

• Simulate a CO₂ sensor device in simulation mode and generate random CO₂ concentration values.
• Connect to a Raspberry Pi Pico via USB to read real CO₂ concentrations.
• Provide device information, sensor data, and network status, accessible via JSON - RPC.
• Support commands for publishing data to MQTT, reconnecting WiFi, and reconnecting MQTT (some functions are simulated).

📦 Installation

You need to have Node.js installed on your computer to run this application. If you haven't installed Node.js yet, download and install it from the official website.

1. Clone the repository.
2. Install dependencies using npm:

npm install

📚 Documentation

Configuration

Ensure that the claude_desktop_config.json file is correctly configured to run the server. Here is an example configuration:

{
  "mcpServers": {
    "CO2 sensor": {
      "command": "node",
      "args": [
        "...mcp-server-for-sensor-device/index.js"
      ],
      "env": {}
    }
  }
}

Usage

To start the server, run the following command:

node index.js

JSON - RPC Methods

initialize

Initialize the server and return server capabilities.

shutdown

Shut down the server.

resources/list

List available resources.

resources/read

Read the specified resource.

tools/list

List available tools.

tools/call

Call the specified tool.

DeviceState Class

The DeviceState class emulates the device state and provides methods to get device information, sensor data, and network status. It also handles the connection to the Raspberry Pi Pico to read CO₂ concentrations.

Methods

• getDeviceInfo(): Return device information.
• getSensorData(): Return sensor data.
• getNetworkStatus(): Return the network status (simulated function).
• publishToMQTT(): Simulate publishing data to MQTT (simulated function).
• reconnectWiFi(): Simulate reconnecting to WiFi (simulated function).
• reconnectMQTT(): Simulate reconnecting to MQTT (simulated function).

Logging

The application logs CO₂ concentrations and other information to the log file co2_level.log located in the user's home directory.

📄 License

This project is licensed under the MIT License.