Opentrons MCP

🚀 Opentrons MCP Server

Opentronsロボットの自動化とAPIドキュメント用のモデルコンテキストプロトコル（MCP）サーバーです。このツールは、Opentrons FlexとOT - 2ロボットに対して包括的なAPIドキュメントと直接的なロボット制御機能の両方を提供します。

✨ 主な機能

APIドキュメントツール

• エンドポイント検索：機能、メソッド、またはキーワードでAPIエンドポイントを検索します。
• エンドポイント詳細：特定のAPIエンドポイントに関する包括的な情報を取得します。
• カテゴリブラウジング：機能カテゴリ別にエンドポイントを一覧表示します。
• API概要：Opentrons HTTP API全体の概要を提供します。

ロボット自動化ツール

• プロトコル管理：プロトコルファイルのアップロード、一覧表示、および管理を行います。
• 実行制御：実行を作成、開始/停止し、進行状況を監視します。
• ロボットの状態：接続性とシステムの状態を確認します。
• ハードウェア制御：ロボットを原点復帰させ、ライトを制御し、基本的な操作を行います。

📦 インストール

npmから（推奨）

npm install -g opentrons-mcp

ソースから

git clone https://github.com/yerbymatey/opentrons-mcp.git
cd opentrons-mcp
npm install

設定

Claude Desktopの設定ファイルに追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "opentrons": {
      "command": "opentrons-mcp",
      "args": []
    }
  }
}

ソースからインストールした場合：

{
  "mcpServers": {
    "opentrons": {
      "command": "node",
      "args": ["/path/to/opentrons-mcp/index.js"]
    }
  }
}

利用可能なツール

ドキュメントツール

search_endpoints

機能、メソッド、パス、またはキーワードでOpentrons HTTP APIエンドポイントを検索します。

• query（必須）：検索語
• method（オプション）：HTTPメソッド（GET、POST、PUT、DELETE、PATCH）でフィルタリング
• tag（オプション）：APIカテゴリでフィルタリング
• include_deprecated（オプション）：非推奨のエンドポイントを含める

get_endpoint_details

特定のAPIエンドポイントに関する包括的な詳細を取得します。

• method（必須）：HTTPメソッド
• path（必須）：APIエンドポイントのパス

list_by_category

特定の機能カテゴリ内のすべてのエンドポイントを一覧表示します。

• category（必須）：APIカテゴリ（Health、Control、Protocol Managementなど）

get_api_overview

Opentrons HTTP APIの構造と機能の概要を取得します。

自動化ツール

upload_protocol

Opentronsロボットにプロトコルファイルをアップロードします。

• robot_ip（必須）：ロボットのIPアドレス
• file_path（必須）：プロトコルファイルのパス（.pyまたは.json）
• protocol_kind（オプション）："standard"または"quick - transfer"（デフォルト："standard"）
• key（オプション）：クライアント追跡キー
• run_time_parameters（オプション）：実行時パラメータの値

get_protocols

ロボットに保存されているすべてのプロトコルを一覧表示します。

• robot_ip（必須）：ロボットのIPアドレス
• protocol_kind（オプション）：プロトコルの種類でフィルタリング

create_run

ロボット上で新しいプロトコル実行を作成します。

• robot_ip（必須）：ロボットのIPアドレス
• protocol_id（必須）：実行するプロトコルのID
• run_time_parameters（オプション）：実行時パラメータの値

control_run

実行の制御（再生、一時停止、停止、再開）を行います。

• robot_ip（必須）：ロボットのIPアドレス
• run_id（必須）：制御する実行のID
• action（必須）："play"、"pause"、"stop"、または"resume - from - recovery"

get_runs

ロボット上のすべての実行を一覧表示します。

• robot_ip（必須）：ロボットのIPアドレス

get_run_status

特定の実行の詳細な状態を取得します。

• robot_ip（必須）：ロボットのIPアドレス
• run_id（必須）：確認する実行のID

robot_health

ロボットの状態と接続性を確認します。

• robot_ip（必須）：ロボットのIPアドレス

control_lights

ロボットのライトをオンまたはオフにします。

• robot_ip（必須）：ロボットのIPアドレス
• on（必須）：ライトをオンにする場合はtrue、オフにする場合はfalse

home_robot

ロボットの軸または特定のピペットを原点復帰させます。

• robot_ip（必須）：ロボットのIPアドレス
• target（オプション）：すべての軸の場合は"robot"、特定のマウントの場合は"pipette"
• mount（オプション）："left"または"right"（targetが"pipette"の場合は必須）

💻 使用例

Claude Desktopでの使用

Claude DesktopでOpentrons MCPサーバーを使用し、Flex用の現在のプロトコルを要求した後のスクリーンショット。ロボットのIPアドレスを指定します！

設定が完了すると、自然言語でロボットを制御できます。

プロトコルのアップロード：

Upload the protocol file at /path/to/my_protocol.py to my robot at 192.168.1.100

ロボットの状態を確認：

Check if my robot at 192.168.1.100 is healthy and ready

プロトコルの実行：

List all protocols on my robot, then create and start a run for the latest one

進行状況の監視：

Show me the status of run abc123 on my robot

プログラムによる使用

import { Client } from "@modelcontextprotocol/sdk/client/index.js";

// Connect to MCP server
const client = new Client(/* transport */);

// Upload protocol
await client.request({
  method: "tools/call",
  params: {
    name: "upload_protocol",
    arguments: {
      robot_ip: "192.168.1.100",
      file_path: "/path/to/protocol.py",
      protocol_kind: "standard"
    }
  }
});

必要条件

• Node.js 18+
• HTTP APIが有効になっているOpentronsロボット（ポート31950）
• クライアントとロボット間のネットワーク接続性

ロボットのセットアップ

Opentronsロボットが以下の条件を満たしていることを確認してください。

1. クライアントと同じネットワークに接続されている
2. ロボットソフトウェアバージョン7.0.0以上が実行されている
3. ポート31950（HTTP APIのデフォルト）でアクセス可能である

ブラウザでhttp://your-robot-ip:31950/healthにアクセスすることで、接続性を確認できます。

📚 ドキュメント

このツールは、Opentrons HTTP API全体にアクセスできます。以下の機能が含まれます。

• プロトコル管理：プロトコルファイルのアップロード、分析、および管理
• 実行管理：プロトコル実行の作成、制御、および監視
• ハードウェア制御：ロボットの移動、原点復帰、照明、およびキャリブレーション
• システム管理：状態監視、設定、および診断
• モジュール制御：温度モジュール、磁気モジュール、サーモサイクラー
• データ管理：実行時パラメータ用のCSVファイル

詳細なAPIドキュメントについては、このMCPサーバーが提供する検索およびドキュメントツールを使用してください。

トラブルシューティング

ロボットに接続できない場合

• ロボットのIPアドレスが正しいことを確認します。
• ロボットが電源オンでネットワークに接続されていることを確認します。
• ポート31950がアクセス可能であることを確認します。
• ロボットソフトウェアが実行されていることを確認します。

プロトコルのアップロードが失敗する場合

• ファイルパスが存在し、読み取り可能であることを確認します。
• プロトコルファイルが有効なPython（.py）またはJSON形式であることを確認します。
• ロボットの空きディスク容量を確認します。
• プロトコルがロボットの種類（OT - 2 vs Flex）と互換性があることを確認します。

実行に問題がある場合

• すべての必要なラボウェアとモジュールが取り付けられていることを確認します。
• ロボットのキャリブレーション状態を確認します。
• プロトコルの分析が正常に完了したことを確認します。
• ハードウェアエラーまたは競合がないことを確認します。

コントリビューション

コントリビューションは大歓迎です！問題やプルリクエストを自由に提出してください。

📄 ライセンス

No license go brazy

関連プロジェクト

• Opentrons API Documentation
• Model Context Protocol
• Claude Desktop