MCP Server For Sensor Device

🚀 MCP Server for CO2 Sensor Device

This project is a Node.js-based application designed to work with Claude Desktop. It simulates a CO2 sensor device and provides a JSON-RPC server for device interaction. The application can run in both simulation mode and real mode. In real mode, it connects to a Raspberry Pi Pico via USB to read CO2 levels.

🚀 Quick Start

This application is a Node.js-based project designed to be used with Claude Desktop. It emulates a CO2 sensor device and offers a JSON-RPC server for device interaction. The application supports both simulation and real - world operation modes. In the real - world mode, it connects to a Raspberry Pi Pico via USB to read actual CO2 levels.

✨ Features

• In simulation mode, it emulates a CO2 sensor device and generates random CO2 levels.
• Connects to a Raspberry Pi Pico via USB to read real CO2 levels.
• Provides device information, sensor data, and network status via JSON - RPC.
• Supports publishing data to MQTT, reconnecting to WiFi, and reconnecting to MQTT (some functions are simulated).

📦 Installation

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

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

npm install

📚 Documentation

Configuration

Ensure that the claude_desktop_config.json file is correctly configured to run the server. An example configuration is as follows:

{
  "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

Initializes the server and returns server capabilities.

shutdown

Shuts down the server.

resources/list

Lists available resources.

resources/read

Reads a specified resource.

tools/list

Lists available tools.

tools/call

Calls a specified tool.

DeviceState Class

The DeviceState class simulates device state and provides methods to get device information, sensor data, and network status. It also handles the connection to the Raspberry Pi Pico and reads CO2 levels.

Methods

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

Logging

The application logs CO2 levels and other information to the co2_level.log file in the user's home directory.

📄 License

This project is licensed under the MIT License.