Epics MCP Server

🚀 EPICS-MCP-Server

EPICS-MCP-Serverは、EPICS（Experimental Physics and Industrial Control System）のプロセス変数（PV）とやり取りするために設計されたPythonベースのサーバーです。PVの値を取得、設定し、PVに関する詳細情報を取得する一連のツールを提供します。このサーバーはmcpフレームワークを使用して構築され、stdioを介して通信するため、大規模な制御システムやワークフローに統合するのに適しています。

🚀 クイックスタート

EPICS MCP Serverを使用するには、まず必要な依存関係をインストールする必要があります。

pip install -r requirements.txt

EPCIS mcpサーバーを使用する前に、ローカルマシンにEPCISを正常にインストールし、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+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 Serverは以下のツールを提供します。

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オブジェクト。

💻 使用例

基本的な使用法

Langchainと一緒に使用するには、まずプロジェクトに必要な依存関係をインストールする必要があります。

pip install -r requirements.txt

高度な使用法

server_params = StdioServerParameters(
    command="python",
    # Make sure to update to the full absolute path to your math_server.py file
    args=["/path/server.py"],
)

テスト結果

Mcpクライアント:

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            # Initialize the connection
            await session.initialize()

            # Get tools
            tools = await load_mcp_tools(session)

            # Create and run the agent
            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.