EPICS Process Variable Bridge

🚀 EPICS - MCP 服務器

EPICS MCP 服務器是一個基於 Python 的服務器，用於與 EPICS（實驗物理和工業控制系統）的過程變量（PVs）進行交互。它提供了獲取 PV 值、設置 PV 值以及獲取 PV 詳細信息的工具，適合集成到更大的控制系統或工作流中，在監控和控制硬件或軟件參數的環境中非常實用。

🚀 快速開始

要與 Langchain 結合使用，必須安裝項目所需的依賴項：

pip install -r requirements.txt

Langchain

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 的詳細信息。

✨ 主要特性

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 或其他高級場景的使用說明
server_params = StdioServerParameters(
    command="python",
    # 確保將 math_server.py 文件的完整絕對路徑更新到此處
    args=["/path/server.py"],
)

📚 詳細文檔

測試結果

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

測試結果顯示，PV temperature:water 的當前值已成功設置為 100.0。