Particle MCP Server について
Particle MCP Serverは、AIアシスタントをParticle IoTプラットフォームに接続し、デバイスやフリートを管理します。デバイス操作、診断、組織・製品・ファームウェアに関するツールを提供します。
主な機能
- 01デバイスと製品デバイスの一覧表示
- 02デバイス名の変更とメモの追加
- 03デバイスへのPingと関数呼び出し
- 04デバイスの稼働情報の取得
- 05組織・製品・ファームウェアの一覧表示
活用シーン
- 01デバイスのオンライン状態と稼働情報の確認
- 02Particleデバイス上での関数実行
- 03デバイス名とメモの管理
- 04組織の製品とファームウェアの確認
MCP 対応
デバイス管理、診断、組織・製品の一覧表示、ファームウェアの一覧表示など、Particleプラットフォームの操作をMCPクライアント向けのツールとして公開します。利用にはParticle APIトークンが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Particle MCP サーバー
Particle IoT プラットフォーム向けの Model Context Protocol サーバーです。AI アシスタントが自然言語を使って Particle デバイスを管理できるようにします。
対応する機能/API エンドポイント
デバイス
- list_devices - アカウント内のすべてのデバイスを一覧表示します
- list_product_devices - 指定した製品内のすべてのデバイスを一覧表示します
- rename_device - node_id を変更せずにデバイス名を変更します
- add_device_notes - デバイスにメモを追加します
- ping_device - デバイスがオンラインかどうかを確認します
- call_function - 特定のデバイスで指定した関数を呼び出します
診断
- get_device_vitals - 特定のデバイスの最新の状態情報を取得します
組織
- list_organizations - アカウントに属するすべての組織を一覧表示します
- list_organization_products - 組織内のすべての製品を一覧表示します
製品ファームウェア
- list_product_firmware - 特定の製品 ID のすべてのファームウェアバージョンを一覧表示します
セットアップとインストール
以下に示す構成で .env ファイルを作成します
# Particle API credentials
PARTICLE_ACCESS_TOKEN = your_api_token
Particle API トークンを生成するには、Particle CLI がインストールされていることを確認し、次のコマンドを実行します。
particle token create
使用方法
このリポジトリをクローンします
Claude Desktop を開きます
Settings に移動します
Developer をクリックします
Edit Config をクリックします
以下を貼り付けます:
{
"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 は「小さく」保ってください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。