🚀 粒子 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 小而精简。