JinDaGe - EPICS-MCP-Server MCP Details

article

README

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

... 启动日志 ...

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

✨ 主要特性

EPICS MCP 服务器提供了以下工具：

get_pv_value
- 功能：创建或更新单个文件。
- 输入：
  - pv_name (字符串)：PV 变量的名称。
- 返回：包含状态 (success 或 error) 和检索到的值或错误消息的 JSON 对象。
set_pv_value
- 功能：为指定的 PV 设置新值。
- 输入：
  - pv_name (字符串)：PV 变量的名称。
  - pv_value (字符串)：要设置的新 PV 值。
- 返回：包含状态 (success 或 error) 和确认消息或错误消息的 JSON 对象。
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"
}

EPICS-MCP-Server