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