Atlas Scientific EZO Sensors

Atlas Scientific EZO Sensors — MCP サーバー

AI エージェントを使って、ドキュメント化された UART コマンドセットで Atlas Scientific EZO™ センサー回路（pH、ORP、溶存酸素、導電率、RTD 温度、湿度、CO2、圧力）の読み取り、校正、記録ができます。バイオリアクター、細胞培養液、発酵、水耕栽培、水産養殖、環境モニタリングに役立ちます。

パッケージ	labmcp-atlas-ezo
機器	EZO-pH、EZO-ORP、EZO-DO、EZO-EC、EZO-RTD、EZO-HUM、EZO-CO2、EZO-PRS（iで種類を自動検出）
インターフェース	USB-シリアルアダプターまたはAtlas絶縁キャリアボード経由のUART、あるいはシリアル-イーサネットブリッジ（ポートごとに1回路）
プロトコル	EZO UART コマンドセット（pH データシート V 6.1、ORP V 5.2、DO V 5.8、EC V 6.7、RTD V 3.7、HUM V 1.5、CO2 V 2.3、PRS V 2.3）
ステータス	🧪 シミュレーション済み：ワイヤレベルのEZOシミュレーターでテスト済みですが、実機ではまだ検証されていません。実機テストを報告

ハードウェアなしで試す

uvx labmcp-atlas-ezo --simulate --check
uvx labmcp-atlas-ezo --simulate --option sim_sensor=DO --check     # also ORP, EC, RTD, HUM, CO2, PRS

機器を接続する

1. 回路の設定：回路はUARTモードに設定してください（LEDが緑／シアンに点灯します。青色はI2Cモードです。データシートの「Change to UART mode」を参照してください）。工場出荷時の設定は9600ボー、データビット8、パリティなし、ストップビット1、フロー制御なし、CR改行です。回路とアダプターのTX/RXを交差して接続してください。プローブがほかのプローブやポンプと同じ液体に入る場合は、電気的に絶縁されたキャリアボードを使用してください。
2. ポートを確認する：uvx labmcp ports
3. 接続をテストする：

   uvx labmcp-atlas-ezo --address /dev/ttyUSB0 --check                # Linux
   uvx labmcp-atlas-ezo --address /dev/tty.usbserial-XXXX --check     # macOS
   uvx labmcp-atlas-ezo --address COM5 --check                        # Windows
   uvx labmcp-atlas-ezo --address "serial://COM5?baudrate=38400" --check   # non-default baud rate
   

   接続時、サーバーはC,0（連続読み取りをオフにし、応答と読み取りが混在しないようにする）と*OK,1（応答コードをオンにする。工場出荷時の既定値）を送信します。回路はこれらの設定を電源の入れ直し後も保持します。

MCP クライアントに追加する

Claude Code

claude mcp add ph-probe -- uvx labmcp-atlas-ezo --address /dev/ttyUSB0

Claude Desktop / Cursor / Windsurf（claude_desktop_config.json、.cursor/mcp.json、…）

{
  "mcpServers": {
    "ph-probe": {
      "command": "uvx",
      "args": ["labmcp-atlas-ezo", "--address", "/dev/ttyUSB0"]
    },
    "do-probe": {
      "command": "uvx",
      "args": ["labmcp-atlas-ezo", "--address", "/dev/ttyUSB1"]
    }
  }
}

回路ごとにサーバーを1つ起動してください。読み取りを許可しつつ、校正や設定変更を禁止するには--read-onlyを追加します。ほかのクライアントの場合は、uvx labmcp config atlas-ezo --address /dev/ttyUSB0 --client vscodeで設定スニペットを生成してください。

ツール

ツール	種類	説明
calibrate	🎛 制御	校正ポイントを1つ保存します。プローブは、安定した測定値が得られる状態で、指定された標準液（バッファー、空気、乾燥状態など）に浸しておく必要があります。ポイント名は回路の種類ごとに検証されます。pH：mid 校正を行うと既存の低点／高点が消去されるため、必ず最初に mid を行ってください。EC：最初に dry を行ってください。
clear_calibration	🎛 制御	保存されている校正データをすべて削除します（Cal,clear）。pH／ORP／DO／EC／RTD は未校正の状態に戻り、CO2／PRS は工場出荷時の校正に戻ります。その後、プローブを再校正する必要があります。
get_calibration_status	👁 読み取り	保存されている校正ポイントの数と、回路の種類ごとの意味を報告します。pH の場合は、プローブの傾き（理想値に対する酸／塩基の割合と、mV 単位のゼロオフセット）も報告します。
get_command_log	👁 読み取り	機器に送信した最新の生コマンドと、機器から受信した応答を返します（新しいものが最後）。デバッグや実行内容の記録に役立ちます。
get_connection_info	👁 読み取り	接続中の機器（識別情報、アドレス、シミュレーションか実機か）、サーバーが読み取り専用かどうか、適用中の安全制限を報告します。最初に呼び出してください。
get_info	👁 読み取り	回路の種類、ファームウェア、デバイス名、電源電圧、最後の再起動理由、LED の状態、校正状態、温度補償、種類固有の設定（有効な出力、EC プローブ定数 K、DO の塩分濃度／圧力補償）を報告します。
log_series	👁 読み取り	一連の測定値を記録します（例：校正前にプローブの安定状態を確認する、バイオリアクター内の pH や DO を追跡する、温度を記録する）。各出力の全測定点に加え、平均、標準偏差、最小値、最大値、1 分あたりのドリフトを返します。
read_value	👁 読み取り	1 回（約 1 秒）の測定を行い、単位とともに有効な出力をすべて返します。pH、mV 単位の ORP、mg/L 単位の DO（有効な場合は飽和率も）、µS/cm 単位の EC と、有効な場合は TDS（ppm）、塩分濃度（PSU）、比重、RTD 温度、湿度 %RH（および気温、露点）、CO2 ppm、または圧力を返します。
reconnect	🛑 安全	機器との接続を閉じて再度開きます（電源を入れ直した場合や、ケーブルを差し直した場合など）。
set_do_compensation	🎛 制御	DO 回路専用：塩分濃度補償（約 2500 µS/cm 未満では無関係）および／または大気圧補償を設定します（デフォルトは 101.3 kPa。標高が高い場合は低く設定します）。電源を入れ直すと設定は保持されません。
set_led	🎛 制御	回路のステータス LED を点灯または消灯します。新しい LED の状態を返します。
set_probe_constant	🎛 制御	EC 回路専用：導電率プローブのセル定数 K を、プローブに印字された値に合わせて設定します。変更後は再校正してください。現在使用中の K を返します。
set_temperature_compensation	🎛 制御	pH、EC、または DO の測定値を補償するために使用する試料温度を設定します（T,n。単位は常に °C）。電源を入れ直すと設定は保持されません。回路が現在使用している値を返します。

get_connection_info、get_command_log、reconnect は、すべての LabMCP サーバーに組み込まれています。

安全制限

制限	デフォルト	意味
max_series_duration_s	600 s	エージェントが開始できる記録シリーズの最長時間

起動時に上書きします：--limit max_series_duration_s=3600（3600 s は 1 回の log_series 呼び出しで実行できる最長時間です。それより長い記録は複数回に分けてください）。log_series は、任意の save_path を新規の .csv ファイルにのみ書き込みます（既存ファイルは上書きされません）。これらの回路は測定のみを行うため、危険なツールはありません。リスクは 誤った校正 です。そのため calibrate は回路の種類ごとにポイント名と標準値を検証し、clear_calibration は --read-only モードでは非表示になります。

プロンプトの例

• 「どのセンサーが接続されていますか？校正済みですか？pH のスロープはいくつですか？」
• 「pH プローブを pH 7.00 の緩衝液に入れています。±0.01 以内で安定するまで 2 秒ごとに記録し、その後、中点を校正してください。続けて pH 4 と pH 10 の手順を案内してください。」
• 「バイオリアクターは 37 °C です。温度補償を設定し、溶存酸素を mg/L と飽和率（%）で読み取ってください。」
• 「導電率、TDS、塩分濃度を 30 秒ごとに 10 分間記録し、栄養液の値が変動しているか教えてください。」
• 「光に敏感な培養を行っているので、DO 回路の LED を消してください。」

注意事項

• 回路ごとの単位： pH、ORP は mV、DO は mg/L および（O,%,1 で有効にした場合）飽和率（%）、EC は µS/cm に加えて TDS（ppm）、塩分濃度（PSU）、有効にした場合は比重、RTD は設定された単位（°C/K/°F）、HUM は %RH に加えて、有効にした場合は気温と露点（°C）、CO2 は ppm（+ 内部温度）、PRS は設定された単位（psi、atm、bar、kPa、inH2O、cmH2O）です。有効になっている出力は推測せず、回路から読み取ります（O,?、S,?、U,?）。
• 複数の値を返す読み取り値の出力順は、データシートに従います（EC：EC,TDS,S,SG）。DO の順序（mg/L、次に飽和率）は DO のデータシートに明記されていないため、オープンソースの EnviroDIY ModularSensors と feastorg ezo-driver ライブラリで照合しました。お使いの回路で異なる場合はお知らせください。
• 温度補償（T,n、pH/EC/DO のみ）と DO の塩分濃度／圧力補償は、回路の電源が失われると保持されません。電源の再投入後に再設定してください。読み取り値には、適用中の補償温度が表示されます。
• 校正ルールを適用します： pH は低点／高点の前に中点を校正する必要があります（データシートの注意書きのとおり、新しい mid は低点／高点を消去します）。中点は 6～8、低点は 0～6.5、高点は 7.5～14 です。ORP は ±1020 mV、EC は 0.07～500,000 µS/cm（先に dry を実行）、CO2 の高点は 3000～5000 ppm、RTD は -126～1254 °C です。サーバーは、プローブが実際にどの標準液に入っているかを確認できないため、エージェントがユーザーに確認する必要があります。
• RTD の読み取り値が -1023 の場合、プローブが接続されていません。読み取り値には警告も含まれます。
• P,? などの DO クエリは、データシートのとおり ?,P,90.25（余分なカンマに注意）を返します。ドライバーは両方の形式に対応しています。DO の塩分濃度の応答にはマイクロ記号が含まれるため、ポートは Latin-1 として読み取られます。
• ツールとして公開していない機能（検証済みですが、エージェントには役立たない、またはリスクが高すぎるもの）：Factory（校正を消去）、Sleep、Find、Baud、I2C、Plock、校正の Export／Import、RTD データロガー、HUM/CO2/PRS のアラームピンです。EZO ポンプ（EZO-PMP）およびその他のアクチュエーター回路は、接続時に拒否されます。

ハードウェア検証

モデル	ファームウェア	インターフェース	検証者	日付
まだありません：最初の報告者になる