ESP32 C SDK

このガイドでは、MCP over MQTT C SDK for ESP32 を使用してシンプルな MCP over MQTT サーバーを作成する方法を説明します。現在、MCPサーバーのみがサポートされています。MCPクライアントを作成してやり取りする場合は、Python SDK をご利用ください。

このSDKは ESP-IDF に含まれる MQTT ライブラリを使用しているため、ESP32 デバイスに適しており、ESP-IDF 環境内で使用する必要があります。

MCPサーバーの作成

ESP32 C SDK README の指示に従い、ESP-IDF プロジェクト内に mcp_server_example.c という新しいファイルを作成し、以下のコードを追加してください。

#include "mcp_server.h"

const char* get_temperature_callback(int n_args, property_t *args) {
    // センサーのデータを読み取る
    float temp = read_temperature_sensor();
    
    // JSON形式の結果を返す
    static char result[64];
    snprintf(result, sizeof(result), "{\"temperature\": %.2f}", temp);
    return result;
}

// MCPツールの定義
mcp_tool_t my_tools[] = {
    {
        .name = "get_temperature",
        .description = "デバイスの温度を取得",
        .property_count = 0,
        .properties = NULL,
        .call = get_temperature_callback
    }
};

// MCPサーバーの初期化
mcp_server_t *server = mcp_server_init(
    "esp32_sensor",             // サーバー名
    "ESP32 Sensor MCP Server",  // 説明
    "mqtt://broker.example.com",// MQTTブローカーのURI
    "esp32_client_001",         // クライアントID
    "username",                 // ユーザー名
    "password",                 // パスワード
    NULL                        // 証明書（オプション）
);

// ツールの登録
mcp_server_register_tool(server, 1, my_tools);

// サーバーの起動
mcp_server_run(server);

ESP-IDFプロジェクトでのMCPサーバーの使用

詳細な使用方法については、ESP32 MCP Demo プロジェクトを参照してください。この例では、ESP-IDFプロジェクトに MCP over MQTT C SDK for ESP32 を組み込み、MCPサーバーをセットアップし、Python SDKで実装されたMCPクライアントと連携する方法を示しています。

ESP-IDFでプロジェクトをビルドし、ESP32デバイスにフラッシュすると、MCPサーバーが自動的に起動します。