EPICS MCP Server

🚀 EPICS - MCP サーバー

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

✨ 主な機能

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

1. get_pv_value

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

2. set_pv_value

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

3. get_pv_info

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

📦 インストール

Langchain との統合

Langchain と共に使用するには、プロジェクトの依存関係をインストールする必要があります。

pip install -r requirements.txt

EPICS

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

💻 使用例

Langchain

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

EPICS

jiangyan@DESKTOP-84CO9VB:~$ softIoc -d ~/EPICS/DB/test.db
Starting iocInit
############################################################################
## EPICS R7.0.8
## Rev. 2025-02-13T14:29+08:00
############################################################################

... 起動ログ ...

jiangyan@DESKTOP-84CO9VB:~$ caget temperature.readback.value
88.0

テスト結果

{
  "pv_name": "temperature.readback.value",
  "pv_value": 88.0,
  "timestamp": "2025-02-13T14:29:00"
}

完全なテストログ

# テストログ

## ステップ 1：IOC を起動する
jiangyan@DESKTOP-84CO9VB:~$ softIoc -d ~/EPICS/DB/test.db
Starting iocInit
############################################################################
## EPICS R7.0.8
## Rev. 2025-02-13T14:29+08:00
############################################################################

... 起動ログ ...

## ステップ 2：PV に接続する
jiangyan@DESKTOP-84CO9VB:~$ caget temperature.readback.value
88.0

## ステップ 3：PV 値を設定する
jiangyan@DESKTOP-84CO9VB:~$ caput temperature.setpoint.value 100
Write access allowed by default.
No security callback
old value = 88.0
new value = 100.0

## ステップ 4：PV 情報を取得する
jiangyan@DESKTOP-84CO9VB:~$ cainfo temperature.readback.value
{
  "pv_name": "temperature.readback.value",
  "description": "Temperature Readback Value",
  "type": "double",
  "value": 100.0,
  "alarm Severety": "NO_ALARM",
  "timeStamp": "2025-02-13T14:29:00"
}