返回 MCP 目录
public公开dns本地运行

MCP-Server-for-sensor-device

一个Node.js应用,模拟或真实连接树莓派Pico的CO2传感器,提供JSON-RPC服务接口,支持模拟模式与真实设备模式切换。

article

README

🚀 二氧化碳传感器设备的MCP服务器

本项目是一个基于Node.js的应用程序,专为与Claude Desktop协同使用而设计。它模拟二氧化碳(CO2)传感器设备,并提供JSON - RPC服务器,用于与设备进行交互。该应用程序支持模拟模式和真实模式,在真实模式下,可通过USB连接到Raspberry Pi Pico读取实际的CO2水平。

🚀 快速开始

您需要在机器上安装Node.js才能运行此应用程序。如果您没有安装Node.js,可以从官方网站下载并安装它。

  1. 克隆仓库。

  2. 使用npm安装依赖项:

    npm install
    
  3. 确保claude_desktop_config.json文件正确配置以运行服务器。示例配置如下:

{
  "mcpServers": {
    "CO2传感器": {
      "command": "node",
      "args": [
        "...mcp-server-for-sensor-device/index.js"
      ],
      "env": {}
    }
  }
}
  1. 要启动服务器,请运行以下命令:
node index.js

✨ 主要特性

  • 模拟功能:在模拟模式下,可模拟一个CO2传感器设备,并生成随机的CO2水平。
  • 真实数据读取:通过USB连接到Raspberry Pi Pico,读取真实的CO2水平。
  • JSON - RPC交互:提供设备信息、传感器数据和网络状态通过JSON - RPC。
  • 扩展功能支持:支持发布数据到MQTT、重新连接WiFi和重新连接MQTT(部分功能被模拟)。

📦 安装指南

您需要在机器上安装Node.js才能运行此应用程序。如果您没有安装Node.js,可以从官方网站下载并安装它。

  1. 克隆仓库。

  2. 使用npm安装依赖项:

    npm install
    

📚 详细文档

配置

确保claude_desktop_config.json文件正确配置以运行服务器。示例配置如下:

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

使用方法

要启动服务器,请运行以下命令:

node index.js

JSON - RPC 方法

initialize

初始化服务器并返回服务器功能。

shutdown

关闭服务器。

resources/list

列出可用资源。

resources/read

读取指定的资源。

tools/list

列出可用工具。

tools/call

调用指定的工具。

DeviceState 类

DeviceState类模拟设备状态,并提供方法来获取设备信息、传感器数据和网络状态。它还处理与Raspberry Pi Pico的连接并读取CO2水平。

方法

  • getDeviceInfo(): 返回设备信息。
  • getSensorData(): 返回传感器数据。
  • getNetworkStatus(): 返回网络状态(模拟功能)。
  • publishToMQTT(): 模拟发布数据到MQTT(模拟功能)。
  • reconnectWiFi(): 模拟重新连接到WiFi(模拟功能)。
  • reconnectMQTT(): 模拟重新连接到MQTT(模拟功能)。

日志记录

应用程序将CO2水平和其他信息记录到用户主目录中的co2_level.log文件中。

📄 许可证

此项目使用MIT许可证。

即贴即用配置

MCP 客户端配置生成器

选择客户端,补齐所需环境变量,再复制根据当前 MCP 公开配置生成的完整文件

terminal
data_object

当前条目没有标准 command 或远程 URL,暂时无法安全生成客户端配置

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端