EPICS Process Variable Bridge

🚀 EPICS-MCP-Server

EPICS-MCP-Serverは、Pythonベースのサーバーで、EPICS（実験物理および産業制御システムの略称）のプロセス変数（PVs）とのやり取りを行います。このサーバーは、PVの値を取得し、設定し、詳細情報を取得するための一連のツールを提供します。mcpフレームワークを使用して構築され、stdioを介して通信するため、より大規模な制御システムやワークフローに容易に統合できます。このツールは、EPICS PVを使用してハードウェアまたはソフトウェアのパラメータを監視および制御する環境で特に有用です。

✨ 主な機能

EPICS MCPサーバーは以下のツールを提供します。

1. get_pv_value

   • リポジトリ内の単一のファイルを作成または更新します。
   • 入力:
     • pv_name（文字列）：PV変数の名前。
   • 戻り値：状態 (success または error) と取得した値またはエラーメッセージを含むJSONオブジェクト。

2. set_pv_value

   • 指定されたPVに新しい値を設定します。
   • 入力:
     • pv_name（文字列）：PV変数の名前。
     • pv_value（文字列）：設定する新しい値。
   • 戻り値：状態 (success または error) と確認メッセージまたはエラーメッセージを含むJSONオブジェクト。

3. get_pv_info

   • 指定されたPVの詳細情報を取得します。
   • 入力:
     • pv_name（文字列）：PV変数の名前。
   • 戻り値：状態 (success または error) とPVの詳細情報またはエラーメッセージを含むJSONオブジェクト。

🚀 クイックスタート

Langchainとの連携

Langchainと組み合わせて使用するには、プロジェクトに必要な依存関係をインストールする必要があります。

pip install -r requirements.txt

server_params = StdioServerParameters(
    command="python",
    # 確実にmath_server.pyファイルの完全な絶対パスをここに更新してください
    args=["/path/server.py"],
)

EPICSのセットアップ

EPICS mcpサーバーを使用する前に、ローカルコンピューターにEPICSを正常にインストールし、IOCが正常に起動できることを確認し、caget、caput、cainfo などの機能が正常に動作することを検証する必要があります。詳細なインストール手順については、https://epics-controls.org/resources-and-support/base/ を参照してください。

jiangyan@DESKTOP-84CO9VB:~$ softIoc -d ~/EPICS/DB/test.db
Initializing, Fri Sep 20 13:35:29 2024

No devices specified.  DBD file: /home/jiangyan/EPICS/DB/test.db

Record 'calc' is not defined.

Press <Enter> to continue...

jiangyan@DESKTOP-84CO9VB:~$ caput temperature:water 100.0
caput: 成功写入温度:water 的值为 100.0。

jiangyan@DESKTOP-84CO9VB:~$ caget temperature:water
caget: 温度:water 的当前值是 100.0。

jiangyan@DESKTOP-84CO9VB:~$ cainfo temperature:water
cainfo: 显示温度:water 的详细信息。

💻 使用例

基本的な使用法

{
  "status": "success",
  "value": 100.0
}

テスト結果は、PV temperature:water の現在の値が100.0に正常に設定されたことを示しています。