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 トークンを生成するには、Particle CLI がインストールされていることを確認し、以下のコマンドを実行します。

particle token create

💻 使用例

基本的な使用法

このリポジトリをクローンします。

Claude Desktop を開きます。

設定メニューにアクセスします。

開発者オプションをクリックします。

構成を編集するをクリックします。

以下の内容を貼り付けます。

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

🤝 コントリビューションガイド

こちらのリンクを参照して、Postman で Particle API 環境を設定し、各 API エンドポイントに対応するツールを実装してください。PR を提出してコードを貢献してください。我々がレビューいたします！PR は小さくてシンプルなものにしてください。