Particle MCP Server

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