JinDaGe - particle-mcp-server MCP Details

article

README

🚀 粒子 MCP 服务器

粒子 MCP 服务器是一个适用于 Particle IoT 平台的模型上下文协议服务器，它能让 AI 助手借助自然语言对粒子设备进行管理，极大地提升了设备管理的便捷性和智能化程度。

✨ 主要特性

设备管理

list_devices：可列出您账户下的所有设备，方便您全面掌握设备情况。
list_product_devices：能在指定产品中列出所有设备，便于按产品维度进行设备管理。
rename_device：重命名设备，同时保留节点 ID 不变，确保设备标识的连贯性。
add_device_notes：可向特定设备添加注释，方便记录设备相关信息。
ping_device：检查设备是否在线，及时了解设备状态。
call_function：调用特定设备上的指定函数，实现对设备的灵活控制。

诊断功能

get_device_vitals：获取特定设备的最新已知运行状况数据，为设备的健康监测提供支持。

组织管理

list_organizations：列出您参与的所有组织，清晰展示组织参与情况。
list_organization_products：列出组织中的所有产品，便于对组织内的产品进行管理。

产品固件管理

list_product_firmware：列出特定产品 ID 的所有固件版本，方便进行固件版本管理。

📦 安装指南

创建环境文件

创建一个 .env 文件，其结构如下：

# 粒子 API 凭证
PARTICLE_ACCESS_TOKEN = 您的_api_令牌

生成 API 令牌

要生成粒子 API 令牌，需确保 Particle CLI 已安装，并运行以下命令：

particle token create

💻 使用示例

基础用法

克隆此仓库。
打开 Claude Desktop。
进入设置菜单。
点击开发者选项。
点击编辑配置。
粘贴以下内容：

{
    "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 小而精简。

particle-mcp-server