🚀 粒子 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

💻 使用示例

基础用法

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

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

📚 详细文档

贡献指南

请参考 此链接 按照说明设置 Postman 中的 Particle API 环境，为每个 API 端点实现一个工具。若您想为项目贡献代码，请提交 PR，我们会进行审核。请保持 PR 小而精简。