Epics MCP Server

🚀 EPICS-MCP-Server

EPICS-MCP-Server 是一個基於 Python 的服務器，旨在與 EPICS（實驗物理和工業控制系統）過程變量（PV）進行交互。它提供了一組工具，用於檢索 PV 值、設置 PV 值以及獲取 PV 的詳細信息。該服務器使用 mcp 框架構建，並通過標準輸入輸出進行通信，適合集成到更大的控制系統或工作流程中。

🚀 快速開始

依賴安裝

若要將此服務器與 Langchain 結合使用，你需要安裝項目所需的依賴項：

pip install -r requirements.txt

Langchain 配置

server_params = StdioServerParameters(
    command="python",
    # 請確保更新為你的 math_server.py 文件的完整絕對路徑
    args=["/path/server.py"],
)

EPICS 安裝與驗證

在使用 EPCIS mcp 服務器之前，你必須在本地機器上成功安裝 EPCIS，確保 IOC 能夠正常啟動，並驗證 caget、caput 和 cainfo 等功能是否正常工作。詳細的安裝說明請參考 https://epics-controls.org/resources-and-support/base/。

以下是啟動 IOC 並驗證功能的示例：

jiangyan@DESKTOP-84CO9VB:~$ softIoc -d ~/EPICS/DB/test.db
Starting iocInit
############################################################################
## EPICS R7.0.8
## Rev. 2025-02-13T14:29+0800
## Rev. Date build date/time:
############################################################################
iocRun: All initialization complete
epics>

jiangyan@DESKTOP-84CO9VB:~$ caget temperature:water
temperature:water              88
jiangyan@DESKTOP-84CO9VB:~$ caput temperature:water 100
Old : temperature:water              88
New : temperature:water              100
jiangyan@DESKTOP-84CO9VB:~$ cainfo temperature:water
temperature:water
    State:            connected
    Host:             127.0.0.1:5056
    Access:           read, write
    Native data type: DBF_DOUBLE
    Request type:     DBR_DOUBLE
    Element count:    1

✨ 主要特性

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

1. get_pv_value

   • 功能：獲取指定 PV 的值。
   • 輸入：
     • pv_name（字符串）：PV 變量的名稱。
   • 返回：一個 JSON 對象，包含狀態（success 或 error）以及檢索到的值或錯誤消息。

2. set_pv_value

   • 功能：為指定的 PV 設置新值。
   • 輸入：
     • pv_name（字符串）：PV 變量的名稱。
     • pv_value（字符串）：要為 PV 設置的新值。
   • 返回：一個 JSON 對象，包含狀態（success 或 error）以及確認消息或錯誤消息。

3. get_pv_info

   • 功能：獲取指定 PV 的詳細信息。
   • 輸入：
     • pv_name（字符串）：PV 變量的名稱。
   • 返回：一個 JSON 對象，包含狀態（success 或 error）以及 PV 的詳細信息或錯誤消息。

💻 使用示例

基礎用法

以下是使用 Mcp 客戶端的示例：

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            # 初始化連接
            await session.initialize()

            # 獲取工具
            tools = await load_mcp_tools(session)

            # 創建並運行代理
            agent = create_react_agent(model, tools)
            agent_response = await agent.ainvoke({"messages": "To query the value of a PV (Process Variable) named temperature:water"})
            return agent_response
)

測試結果

================================ Human Message =================================

To query the value of a PV (Process Variable) named temperature:water
================================== Ai Message ==================================
Tool Calls:
  get_pv_value (call_vvbXwi51CyYUxEM0hcyvCFCY)
 Call ID: call_vvbXwi51CyYUxEM0hcyvCFCY
  Args:
    pv_name: temperature:water
================================= Tool Message =================================
Name: get_pv_value

{
  "status": "success",
  "value": 88.0
}
================================== Ai Message ==================================

The current value of the PV named `temperature:water` is 88.0.