mcpField
P
Particle MCP Server

Particle MCP Server

本地服务
github.com/zradlicz云与基础设施072 周前更新

关于 Particle MCP Server

Particle MCP Server 将 AI 助手连接到 Particle IoT 平台,用于管理设备和设备群组。它提供设备操作、诊断、组织、产品及固件相关工具。

主要功能

  1. 01列出设备和产品设备
  2. 02重命名设备并添加备注
  3. 03Ping 设备并调用函数
  4. 04获取设备运行指标
  5. 05列出组织、产品和固件

适用场景

  1. 01检查设备是否在线及其运行指标
  2. 02在 Particle 设备上运行函数
  3. 03管理设备名称和备注
  4. 04查看组织产品及固件

MCP 相关

将 Particle 平台操作作为工具提供给 MCP 客户端,涵盖设备管理、诊断、组织和产品列表以及固件列表。访问需要 Particle API 令牌。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Python 3.7+ License: MIT

Particle MCP 服务

适用于 Particle IoT 平台的模型上下文协议服务,可让 AI 助手通过自然语言管理 Particle 设备。

涵盖的功能/API 端点

设备
  • list_devices - 列出账户中的所有设备
  • list_product_devices - 列出指定产品中的所有设备
  • rename_device - 重命名设备,但保留相同的 node_id
  • add_device_notes - 为设备添加备注
  • ping_device - ping 设备以检查其是否在线
  • call_function - 在指定设备上调用指定函数
诊断
  • get_device_vitals - 获取特定设备最后一次已知的运行状态
组织
  • list_organizations - 列出账户所属的所有组织
  • list_organization_products - 列出组织中的所有产品
产品固件
  • list_product_firmware - 列出指定产品 ID 的所有固件版本

设置和安装

创建一个 .env 文件,结构如下

# Particle API credentials
PARTICLE_ACCESS_TOKEN = your_api_token

要生成 Particle API 令牌,请确保已安装 Particle CLI,并运行以下命令:

particle token create

使用方法

克隆此仓库

打开 Claude Desktop

导航至 Settings

点击 Developer

点击 Edit Config

粘贴以下内容:

{
    "mcpServers": {
        "particle": {
            "command": "uv",
            "args": [
                "--directory",
                "DIRECT/PATH/TO/particle-mcp-server",
                "run",
                "particle.py"
            ]
        }
    }
}

参与贡献

https://docs.particle.io/reference/cloud-apis/api/#postman

按照说明在 Postman 中设置 Particle API 环境,并为每个 API 端点实现一个工具。提交 PR 供审查!请尽量让 PR 保持“小而精”。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。