openplc-engineering-mcp

OpenPLC 向けに、ドメイン指向で読み取り専用のエンジニアリング操作を公開する小さな Python MCP サーバーです。

このプロジェクトは初期段階の実験的実装です。現在の目的は、MCP 互換エージェントと OpenPLC Editor プロジェクトの間に、最小限かつテスト可能な統合境界を確立することです。

アーキテクチャ

MCP Host / LLM Agent
        |
        | MCP
        v
OpenPLC Engineering MCP
        |
        v
OpenPLC

サーバーは公式の Model Context Protocol Python SDK と stdio トランスポートを使用します。OpenPLC を変更したり、汎用的なファイルシステムやシェルツールを公開したりすることはありません。

Related MCP server: gx3-mcp-server

要件

• Python 3.12+

• uv

• Node.js/npm は MCP Inspector を使用する場合のみ必要です（mcp dev は npx を使用します）

インストール

git clone https://github.com/industrix-com-br/openplc-engineering-mcp.git
cd openplc-engineering-mcp
uv sync

実行

stdio MCP サーバーを起動します：

uv run openplc-engineering-mcp

MCP Inspector で開きます：

uv run mcp dev src/openplc_engineering_mcp/server.py --with-editable .

テスト

uv run pytest

テストは、ツール関数を直接呼び出すのではなく、公式 SDK のインメモリ Client(mcp) インターフェースを使用します。

現在のツール

• get_server_info — サーバーの現在の機能を報告します。

• get_project_structure — OpenPLC Editor プロジェクトの関連構造を返します。

• list_pous — 現在の OpenPLC Editor プロジェクトレイアウトに従って、プログラム、ファンクションブロック、ファンクションを一覧表示します。

OpenPLC プロジェクトの検査は、現在の Editor レイアウトに従います：プロジェクトルートの project.json、pous/programs、pous/function-blocks、pous/functions の配下にある POU、および Editor が使用する関連デバイスとデータ型の場所です。

スコープ

このバージョンは意図的に読み取り専用かつ実験的です。このバージョンには、プロジェクトの変更、コンパイル、デプロイ、ランタイム制御、変数の強制、認証、HTTP トランスポート、無制限のシェル/ファイルシステムアクセスは含まれません。これらの機能は、具体的な要件がそれを正当化する場合にのみ追加されるべきです。