EPICS MCP Server

🚀 EPICS-MCP-Server

EPICS-MCP-Server 是一個基於 Python 的服務器，主要用於與 EPICS（實驗物理和工業控制系統）的過程變量（PVs）進行交互。它提供了一系列工具，可用於獲取、設置 PV 值以及檢索 PV 的詳細信息。該服務器基於 mcp 框架構建，通過 stdio 進行通信，便於集成到更大的控制系統或工作流中，在監控和控制軟硬件參數的場景中十分實用。

🚀 快速開始

要與 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
Starting iocInit
############################################################################
## EPICS R7.0.8
## Rev. 2025-02-13T14:29+08:00
############################################################################

... 啟動日誌 ...

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

✨ 主要特性

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 對象。

💻 使用示例

測試結果

{
  "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"
}