お知らせ:

これは v35 エディション フォーク版の Studio 5000 AI Assistant で、独立してメンテナンスされています。デフォルトでは Studio 5000 Logix Designer v35 を使用しますが、セットアップスクリプトの --version フラグを使用してインストール済みの任意のバージョンをサポートします（下記のStudio 5000 バージョンの選択を参照）。元となったプロジェクトへのクレジット: rivie13/studio5000-AI-Assistant（デフォルトは v36）。このリポジトリはプロトタイプです — フォークして自分用にカスタマイズしていただいて構いません。

🤖 Studio 5000 AI 搭載 PLC プログラミングアシスタント

この革新的な MCP（Model Context Protocol）サーバーは、AI によるコード生成、L5X ルーチン作成、実際の .ACD ファイル生成、そして Studio 5000 とのシームレスな統合を提供することで、PLC プログラミングを変革します。自然言語の仕様を、そのまま動作するラダーロジックと完全な Studio 5000 プロジェクトに変換します！

⚡ TL;DR - ワンコマンドセットアップ

# 1. Get Python 3.12 (NOT 3.11!) from python.org
python --version  # Must show 3.12.x

# 2. Clone the repo
git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
cd THE_Studio5000_AI_Assistant_V35

# 3. Run the setup script — installs everything and writes your config for you
python setup.py

setup.py はインストール済みの Studio 5000 バージョンを検出し（デフォルトは v35）、requirements.txt をインストールし、Logix Designer SDK の wheel ファイルが見つかればそれをインストールし、お使いのマシンに正しいパスが設定されたすぐ使える MCP 設定ファイルを生成し、内蔵のセルフテストを実行します。v35 以外を使用している場合はStudio 5000 バージョンの選択を、生成されたファイルの使い方はsetup.py が生成するものを参照してください。

これだけです！ ✅ 手動で設定したい場合はClaude Desktop の設定に進んでください。または、setup.py が生成したファイルを Claude Desktop / Claude Code に指定するだけでも構いません。

Related MCP server: tiacommander-mcp

🔀 Studio 5000 バージョンの選択

このフォークはデフォルトで v35 を使用しますが、それに固定されているわけではありません。setup.py はマシンにインストールされているすべての Logix Designer バージョンをスキャンし、選択できるようにします:

# Auto-detect and prompt interactively (default: v35 if present)
python setup.py

# Force a specific version, e.g. the upstream project's v36
python setup.py --version 36

# Non-interactive, accept every default (CI / scripted installs)
python setup.py --yes

# Skip prompts but still write straight into Claude Desktop's config
python setup.py --version 37 --write-claude-desktop --yes

バージョンが自動検出されない場合、スクリプトは指定した番号に対して標準の Rockwell インストールパス（...\Logix Designer\ENU\v<N>\Bin\Help\ENU\rs5000）にフォールバックします。インストール先が標準以外の場所にある場合は、サーバー側で --doc-root を使用して上書きしてください（ステップ 5 を参照）。

📦 setup.py が生成するもの

以下のすべてのファイルはマシン固有（絶対パス、お使いの Python インタープリター）で、git 無視されます。python setup.py を再実行すればいつでも再生成できます:

mcp_config.json（.local なし）は参照用のプレーンなテンプレートとしてリポジトリに残ります。手動で編集せず、代わりに setup.py を実行してください。

📚 新チームメンバー向けリソース

🎯 完全なチームガイドが利用可能です:

• 📖 TEAM_USAGE_GUIDE.md - 実際の例付きの完全なワークフローガイド

• ⚡ QUICK_REFERENCE_CARD.md - 日常的なコマンドとショートカット

• 🔧 TEAM_TROUBLESHOOTING_GUIDE.md - 一般的な問題と解決策

🚀 チームメンバーのためのクイックスタート

このツールを使う準備はできましたか？ 次の手順に従ってください:

前提条件 ⚠️ 重要

• Python 3.12（3.11 以前は不可 - SDK が動作しません！）

• Studio 5000 Logix Designer v35 以降がマシンにインストールされていること

• Windows オペレーティングシステム（Studio 5000 SDK は Windows のみ）

インストール手順

1. Python 3.12 を確認:

   python --version
   # Must show Python 3.12.x - if not, install Python 3.12 from python.org

2. クローンしてセットアップを実行:

   git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
   cd THE_Studio5000_AI_Assistant_V35
   python setup.py

   これにより、依存関係、SDK wheel、設定ファイルの生成が 1 つのステップで完了します — 上記のTL;DRを参照してください。以下の手順 2〜3 は、自分で行いたい場合の手動でのステップバイステップの同等手順です。

3. Studio 5000 SDK をインストール（.ACD ファイル用）— setup.py をスキップする場合にのみ必要:

   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

4. インストールをテスト:

   python src/mcp_server/studio5000_mcp_server.py --test

   ✅ 表示されるはず: ドキュメントのインデックス化、SDK 利用可能、テスト合格

5. 使用開始！ - サーバーは Studio 5000 のインストールパスを自動検出します

問題が発生しましたか？ 下記のトラブルシューティングセクションを参照してください。

🚀 AI 搭載機能

🧠 自然言語から PLC コードへ

• AI コード生成: 平易な英語を動作するラダーロジックに変換

  • 「スタートボタンが押されたらモーターを起動し、ストップボタンが押されたら停止する」 → 適切な起動/停止インターロック付きの完全なラダーロジック

• スマートパターン認識: 起動/停止、タイマー、カウンター、基本的な I/O パターンを自動検出

• インテリジェントタグ作成: 説明的な名前を持つ適切な I/O タグを自動生成

• 命令検証: 生成されたコードを公式の Studio 5000 ドキュメントデータベースに対して検証

📁 L5X プロジェクト生成

• プロジェクト構造の作成: プログラム、ルーチン、タグを含む L5X プロジェクトファイルを生成（既存プロジェクトにインポートするルーチンの作成や、手動で開発する空の L5X ファイルの作成が可能）

• 複数コントローラー対応: さまざまな Allen-Bradley コントローラー（1756-L83E、1756-L85E など）をサポート

• ⚠️ 現在の制限: 生成された L5X ファイルには RLL フォーマットの問題があり、手動修正が必要な場合があります

• 構造化出力: XML 構造は Studio 5000 スキーマに従いますが、検証が必要な場合があります

• 💡 ベストプラクティス: プロジェクトテンプレートとして使用し、その後 Studio 5000 でロジックを手動で追加してください

🏭 実際の .ACD プロジェクト作成

• 公式 Studio 5000 SDK 統合: Rockwell の公式 SDK を使用して本物の .ACD ファイルを作成

• Studio 5000 との直接互換性: .ACD ファイルは変換なしで Studio 5000 で直接開けます

• ✅ 空のプロジェクト作成: 手動開発用のクリーンな ACD テンプレート（信頼性あり）

• ⚠️ 完全なプロジェクト作成: 実験的 - MainProgram/MainTask の SDK 部分インポート（信頼性なし）

• バージョン管理: さまざまな Studio 5000 メジャーリビジョンをサポート（デフォルト v35）

• 💡 推奨: 空の ACD 作成 + 手動 L5X インポートのワークフローを使用してください

🔍 ベクター搭載セマンティック検索

• インテリジェント L5X 分析: 大規模な L5X ファイル（49,000 行以上でテスト済み）のセマンティック検索

• 本番規模の処理: 複雑な産業オートメーションプロジェクトを処理

• スマートコード挿入: AI が既存ルーチン内の新しいロジックに最適な位置を見つけます

• 依存関係分析: コンポーネント間の関係と依存関係を自動検出

• パターン認識: コンベア制御、エンコーダーロジック、障害処理、タイマーパターンを理解

• FAISS ベクターデータベース: 埋め込みベースの類似性による超高速セマンティック検索

📐 技術図面分析

• PDF エンジニアリング図面: 技術図面（P&ID、電気回路図、制御ロジック図）の抽出と検索

• AutoCAD 統合: リッチテキストとベクターグラフィックスコンテンツを含む CAD 生成 PDF を解析

• 機器コンテキスト: 機器タグとシステムコンポーネントによって参照される図面を自動的に検索

• ビジョン AI 拡張: 複雑な技術図と機器接続の高度な分析

• 相互参照機能: 図面を既存の L5X コードおよびタグデータベースとリンクし、システム全体の理解を実現

📊 高度な L5X 分析システム

• 実本番テスト: 産業システムからの実際の 2.9MB L5X ファイルで検証済み

• 複雑性スコアリング: ルーチンの複雑性とリファクタリングの必要性を自動評価

• コンポーネントマッピング: タイマー、カウンター、タグ、およびそれらの相互接続を追跡

• 外科的修正: 既存ロジックを妨げずにラングを正確に挿入

• プロフェッショナルワークフロー: SDK 搭載の変更機能による読み取り専用分析

📚 ドキュメントアクセス

• 包括的な命令データベース: 公式の Studio 5000 ドキュメントを検索

• スマート検索: 名前、説明、カテゴリ、または機能で PLC 命令を検索

• 詳細情報: 命令の構文、パラメータ、使用法に関する包括的な詳細を取得

• カテゴリブラウジング: 機能カテゴリ（アラーム、数学、モーション、タイマーなど）で命令を閲覧

• 言語サポート: 各命令がサポートするプログラミング言語（ラダー、ST、FBD）に関する情報

• リアルタイム検証: 公式 Rockwell ドキュメントを使用した即時検証

📋 詳細なインストールガイド

前提条件 - 最初にこれを読んでください！ ⚠️

🚨 重要要件: Python 3.12 のみ

• このプロジェクトは Python 3.12 が必須です - それ以前のバージョンでは失敗します

• Studio 5000 SDK は Python 3.11 以前と互換性がありません

• 続行する前に最初に Python バージョンを確認してください

システム要件:

• Python 3.12.x（python.org からダウンロード）

• Studio 5000 Logix Designer v35 以降がインストールされていること

• Windows オペレーティングシステム（Studio 5000 SDK は Windows のみ）

• 初期セットアップには管理者権限が必要な場合があります

ステップバイステップのセットアップ

ステップ 1: Python 3.12 をインストール

1. ダウンロード: python.org にアクセスし、Python 3.12 をダウンロード

2. インストール: インストール中に、「Add Python to PATH」にチェックを入れる ✅

3. 確認: コマンドプロンプトを開いて実行:

   python --version
   # Must show: Python 3.12.x (if not, restart command prompt)

ステップ 2: プロジェクトを取得

1. リポジトリをクローン:

   git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
   cd THE_Studio5000_AI_Assistant_V35

2. ワンコマンドの方法を希望しますか？ 今すぐ python setup.py を実行してステップ 4に進んでください — Studio 5000 バージョンの選択を含め、ステップ 3 と 3.5 を代わりに実行します。以下の手動ステップは、各要素を完全に制御したい人向けです。

ステップ 3: 依存関係をインストール（重要！）

1. 必要なパッケージをすべてインストール:

   pip install -r requirements.txt

   これによりインストールされるもの:

   • コアコンポーネント: BeautifulSoup、XML 処理、非同期サポート

   • AI とベクター検索: PyTorch、sentence-transformers、FAISS ベクターデータベース

   • セマンティック分析: 命令と L5X 検索用のベクター埋め込み

   • パフォーマンス: 本番使用向けに最適化されたバージョン

   エラーが発生した場合、次を試してください:

   python -m pip install --upgrade pip
   pip install -r requirements.txt

   注記: ベクターデータベースコンポーネント（torch、sentence-transformers、faiss-cpu）はセマンティック検索機能用に含まれています。これらにより、高度な L5X 分析と命令検索機能が有効になります。

ステップ 3.5: Studio 5000 SDK をインストール（.ACD ファイルに重要！）🚨

⚠️ チームメンバーはこのステップを必ず実行してください - .ACD ファイルの作成が不要な場合のみスキップしてください

1. Studio 5000 のインストール内で SDK の wheel ファイルを見つける:

   # Look for this file (version may vary):
   dir "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

2. SDK の wheel ファイルをインストール:

   # Replace with your actual file path and version:
   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-2.0.1-py3-none-any.whl"

3. 代替 - wheel ファイルが見つからない場合:

   # Navigate to the SDK directory and install from there:
   cd "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python"
   pip install logix_designer_sdk-*-py3-none-any.whl

このステップを実行しない場合: ドキュメントと L5X 生成は動作しますが、.ACD ファイルの作成は失敗します！

ステップ 4: インストールをテスト ✅

1. テストコマンドを実行:

   python src/mcp_server/studio5000_mcp_server.py --test

2. 表示されるはず:

   • ✅ 「Documentation indexed successfully」（500 以上の命令が見つかる）

   • ✅ 「SDK Available: True」（SDK の wheel ファイルを正しくインストールした場合）

   • ✅ 「SDK Available: False」（SDK のインストールをスキップした場合は OK - L5X 生成は引き続き動作します）

   • ✅ サンプル検索結果とコード生成テスト

3. SDK の wheel ファイルをインストールしたのに SDK Available が False と表示される場合:

   • wheel ファイルのパスが正しいか確認

   • 次を試す: python -c "import logix_designer_sdk; print('SDK OK')"

4. テストが完全に失敗する場合、トラブルシューティングセクションを確認

🎉 ツールを使用する準備ができました！ 🎉

サーバーはStudio 5000のインストールパスを自動的に検出します。Claude Desktopの設定セクションにスキップして、すぐに使い始めましょう！

ステップ5: 環境変数の設定（上級ユーザーのみ）

⚠️ このステップはスキップしてください - Studio 5000が標準以外の場所にインストールされている場合のみ必要です

オプションA: Windowsの環境変数で設定する

• システムプロパティ → 環境変数を開く

• 以下のユーザー変数またはシステム変数を追加する:

STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python
PYTHON312_PATH=C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe

オプションB: .envファイルを作成する（プロジェクトルートに）:

STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python
PYTHON312_PATH=C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe

4. Studio 5000のパスを確認する:

   ドキュメントパス: Studio 5000のインストール先でこのファイルを探してください:

   <Studio5000_Install>\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm

   一般的な場所:

   • C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000

   • C:\Program Files\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000

   SDKパス: SDK Pythonフォルダを探してください:

   C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python

5. サーバーをテストする:

   # Test with environment variables (recommended)
   python src/mcp_server/studio5000_mcp_server.py --test
   
   # Or test with explicit path
   python src/mcp_server/studio5000_mcp_server.py --doc-root "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000" --test

   成功時の出力には以下が表示されるはずです:

   • ドキュメントのインデックス作成（数百の命令が見つかる）

   • サンプル検索結果

   • AIコード生成テスト

   • SDKの利用可否ステータス

Claude Desktopの設定

python setup.pyを実行した場合、これはすでに完了しています。実際の正しいパス（クローンしたフォルダ、使用中のWindowsユーザー名に関係なく）がclaude_desktop_config.snippet.jsonに書き込まれるか、--write-claude-desktopを指定した場合はClaude Desktopの設定に直接マージされます。手動で入力する必要はありません。

手動で設定しますか？ 以下の内容をClaude Desktopの設定ファイル（通常は%APPDATA%\Claude\config.jsonにあります）に追加してください。YourUsernameとフォルダ名は、実際にこのリポジトリをクローンした場所に置き換えてください。デフォルトの名前でクローンした場合のみ、フォルダ名はTHE_Studio5000_AI_Assistant_V35になります:

Windowsの設定

オプションA: 環境変数を使用する（推奨）

{
  "mcpServers": {
    "studio5000-ai-assistant": {
      "command": "python",
      "args": [
        "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35\\src\\mcp_server\\studio5000_mcp_server.py"
      ],
      "cwd": "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35",
      "env": {
        "STUDIO5000_DOC_PATH": "C:\\Program Files (x86)\\Rockwell Software\\Studio 5000\\Logix Designer\\ENU\\v35\\Bin\\Help\\ENU\\rs5000",
        "STUDIO5000_SDK_PATH": "C:\\Users\\Public\\Documents\\Studio 5000\\Logix Designer SDK\\python"
      }
    }
  }
}

オプションB: コマンドライン引数を使用する

{
  "mcpServers": {
    "studio5000-ai-assistant": {
      "command": "python",
      "args": [
        "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35\\src\\mcp_server\\studio5000_mcp_server.py",
        "--doc-root",
        "C:\\Program Files (x86)\\Rockwell Software\\Studio 5000\\Logix Designer\\ENU\\v35\\Bin\\Help\\ENU\\rs5000"
      ],
      "cwd": "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35"
    }
  }
}

重要な注意事項:

• YourUsernameを実際のWindowsユーザー名に置き換えてください

• Studio 5000のパスをインストール環境に合わせて調整してください

• Python 3.12を使用してください - 必要に応じてフルパスを指定: "command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python312\\python.exe"

代替案: Cursor IDEを使用する

Cursor IDEを使用している場合、このプロジェクトのワークスペースで作業する際、MCPサーバーはデフォルトで利用可能です。サーバーは環境変数が設定されていれば自動的に使用し、CursorのMCP設定で手動で設定することもできます。このプロジェクトではCursor IDEの使用を強くお勧めします。cursor mcp settings（mcp.json）で設定してください。

🛠️ 利用可能なAIツール

設定が完了すると、AIとの会話で以下の強力なツールが利用できます:

🧠 AIコード生成ツール

1. ラダーロジックの生成

ツール: generate_ladder_logic パラメータ:

• specification（文字列）: 希望するPLC動作の自然言語による説明

機能:

• パターン認識: 起動/停止、タイマー、カウンター、基本的なI/Oパターンを自動検出

• スマートタグ生成: 適切なタグ名とデータ型を作成

• 命令の検証: Studio 5000のドキュメントデータベースを使用して検証

例: 「起動ボタンでモーターを起動し、停止ボタンで停止するロジックを作成する」

2. L5Xプロジェクトの作成

ツール: create_l5x_project パラメータ:

• project_spec（オブジェクト）: 以下の内容を含むプロジェクト仕様:

  • name（文字列）: プロジェクト名

  • controller_type（文字列）: コントローラモデル（例: "1756-L83E"）

  • specification（文字列）: ロジックの自然言語による説明

  • save_path（任意の文字列）: L5Xファイルを保存するファイルパス

出力: インポート可能な完全なStudio 5000 L5Xプロジェクトファイル

3. 空の.ACDテンプレートの作成 ✅

ツール: create_acd_project
パラメータ:

• project_spec（オブジェクト）: 以下の内容を含むACDプロジェクト仕様:

  • name（文字列）: プロジェクト名

  • controller_type（文字列）: コントローラモデル

  • major_revision（整数）: Studio 5000のバージョン（デフォルト36）

  • save_path（文字列）: .ACDファイルのファイルパス

出力: 公式のStudio 5000 SDKを使用した空の.ACDファイル - 手動開発の準備ができた状態

⚠️ 重要: 空のプロジェクトのみを作成します。「MainProgram/MainTaskを含む完全なプロジェクト」という主張は信頼できません。

💡 推奨ワークフロー: 空のACDを作成 → Studio 5000でロジックを手動開発

4. ラダーロジックの検証 ⚡ 高速かつ信頼性の高い検証

ツール: validate_ladder_logic パラメータ:

• logic_spec（オブジェクト）: 以下を含む:

  • ladder_logic（文字列）: 検証するラダーロジックコード

  • instructions_used（配列）: 使用するPLC命令のリスト

🎯 高速検証システム:

本番環境対応の高速検証 ⚡

• 速度: 0.001〜0.020秒

• 信頼性: 100%信頼性が高く、外部依存なし

• 検出内容: 構文エラー、無効な命令、括弧の不一致、構造の問題、ロジックパターン

• 要件: なし - 常に動作

• カバレッジ: 500以上のStudio 5000命令に対して検証

出力: エラー、警告、提案を含む包括的な検証レポート

💡 高速検証が優れている理由: 即時結果、100%の信頼性、すべての重要なPLCプログラミングエラーを検出し、開発ワークフローにシームレスに統合できます。複雑なセットアップは不要です！

📚 ドキュメントツール

5. 命令の検索

ツール: search_instructions パラメータ:

• query（文字列）: 検索語（命令名、説明、機能）

• category（任意の文字列）: 命令カテゴリでフィルタリング

機能: 公式のStudio 5000ドキュメントデータベースを検索

6. 命令の詳細を取得

ツール: get_instruction パラメータ:

• name（文字列）: 正確な命令名（例: "TON"、"MOV"、"ADD"、"PID"）

出力: 構文、パラメータ、例、対応言語を含む完全な命令情報

7. カテゴリの一覧表示

ツール: list_categories パラメータ: なし（ダミーパラメータが必要）

出力: 利用可能なすべての命令カテゴリ（アラーム、算術、モーション、タイマーなど）

8. カテゴリ別の命令一覧表示

ツール: list_instructions_by_category パラメータ:

• category（文字列）: カテゴリ名

出力: 指定されたカテゴリ内のすべての命令

9. 命令の構文を取得

ツール: get_instruction_syntax パラメータ:

• name（文字列）: 命令名

出力: 命令の詳細な構文とパラメータ情報

🔍 L5X分析・ベクター検索ツール

10. L5Xコンテンツの検索

ツール: search_l5x_content パラメータ:

• query（文字列）: 自然言語による検索クエリ（例: 「エンコーダーパルスカウンター」、「ジャム検出ロジック」）

• project_file（文字列）: 検索するL5Xファイルのパス

• max_results（整数）: 返す最大結果数（デフォルト: 5）

機能: 既存のL5Xファイルをセマンティック検索して、関連するロジックパターンを見つける

11. L5Xプロジェクト構造の分析

ツール: analyze_routine_structure パラメータ:

• project_file（文字列）: 分析するL5Xファイルのパス

• routine_name（任意の文字列）: 分析する特定のルーチン

出力: 複雑性分析、依存関係マッピング、リファクタリングの推奨事項

12. 最適な挿入ポイントの検出

ツール: find_insertion_point パラメータ:

• project_file（文字列）: 対象のL5Xファイル

• new_logic_description（文字列）: 挿入するロジックの説明

• routine_name（文字列）: 挿入対象のルーチン

出力: 最適なコード配置のための信頼度スコア付きの推奨ラング位置

13. スマートロジック挿入

ツール: smart_insert_logic パラメータ:

• project_file（文字列）: 対象のL5Xファイル

• routine_name（文字列）: 対象のルーチン

• logic_specification（文字列）: 新しいロジックの自然言語による説明

• insertion_point（整数）: 挿入するラング位置

機能: 既存コードの分析に基づく最適な位置へのAI生成ロジックの挿入

📚 SDKドキュメント検索ツール

14. SDKドキュメントの検索

ツール: search_sdk_documentation パラメータ:

• query（文字列）: SDK操作に関する自然言語クエリ

• limit（整数）: 返す最大結果数（デフォルト: 10）

機能: セマンティック理解によるStudio 5000 SDKドキュメントの検索

15. SDK操作の詳細を取得

ツール: get_sdk_operation_info パラメータ:

• name（文字列）: SDK操作名

• operation_type（任意の文字列）: タイプでフィルタリング（メソッド、クラス、列挙型、例）

出力: 例とパラメータを含む詳細なSDK操作情報

📐 PDF技術図面ツール

16. PDF図面のインデックス作成

ツール: index_pdf_drawings パラメータ:

• pdf_file_path（文字列）: 技術図面PDFファイルのパス

• force_rebuild（ブール値）: 既存キャッシュの再インデックスを強制

• use_vision_ai（ブール値）: 高度なビジョンAI分析を有効化

機能: セマンティック検索用に技術PDF図面を処理・インデックス化

17. 技術図面の検索

ツール: search_drawings パラメータ:

• query（文字列）: 自然言語による検索クエリ（例: 「モーターM001の電気接続」）

• drawing_type_filter（任意の文字列）: タイプでフィルタリング（電気、PID、ロジック、IOリスト）

• equipment_filter（任意の文字列）: 機器タグでフィルタリング

出力: 図面のコンテキストとページ参照付きのランク付けされた検索結果

18. 機器コンテキストの検索

ツール: find_equipment_context パラメータ:

• equipment_tag（文字列）: 機器識別子（例: "M001"、"CV-001"）

• context_type（任意の文字列）: 必要なコンテキストのタイプ（電気、プロセス、安全）

機能: 特定の機器に関連するすべての図面とドキュメントを検索

🎯 PLCプロジェクト作成のための3つの強力なアプローチ

このMCPサーバーはPLCプロジェクト作成のための3つの異なるアプローチをサポートしており、それぞれが異なるユースケースに最適化されています:

🥇 アプローチ1: L5X生成 + 手動インポート（制限あり）

🎯 生成内容: MainProgramとMainTaskを含むL5Xプロジェクト構造
⚠️ 出力: 手動でのRLLフォーマット修正が必要な場合があるL5Xファイル
🎯 最適な用途: プロジェクトテンプレートと基本構造の作成
🎯 手動ステップ:

1. L5Xテンプレートを生成（30秒）

2. テキストエディタでRLLフォーマットの問題を修正

3. 修正したL5XをStudio 5000にインポート

使用例: 「コンベア制御用のL5Xプロジェクトテンプレートを作成する」
ツール: create_l5x_project

⚡ 現実的な評価:

• ⚠️ 生成されたL5XにXMLフォーマットの問題がある場合があります

• ✅ プロジェクト構造テンプレートに適しています

• ✅ 修正した必要なロジックのみをインポート

• ✅ ファイルが検証されればプロフェッショナルなワークフロー

🥈 アプローチ2: 空の.ACDテンプレート（信頼性が高い）

✅ 生成内容: 空の.ACDプロジェクトファイル（クリーンなテンプレート）
✅ 出力: Studio 5000で直接開く空のプロジェクト
✅ 最適な用途: 完全に手動開発のための開始点
🛠️ 手動ステップ: MainProgramとMainTaskを自分で作成し、ロジックを手動で開発

使用例: 「手動開発用の空の.ACDテンプレートを作成する」
ツール: create_acd_project

これが機能する理由:

• ✅ 100%信頼性の高い空のプロジェクト作成

• ✅ 失敗する可能性のある複雑なSDK操作なし

• ✅ 手動開発のためのクリーンな基盤

🥉 アプローチ3: AIロジック生成のみ（既存プロジェクト用）

🧠 生成内容: 検証付きのプロフェッショナルなラダーロジック
🧠 出力: コピー＆ペーストで使用できるラダーロジックコード
🧠 最適な用途: 既存の会社プロジェクトへのロジック追加
🧠 手動ステップ: 生成されたロジックを既存のルーチンにコピー

使用例: 「既存プロジェクト用にコンベア制御ロジックを生成する」
ツール: generate_ladder_logic

🎯 現在のステータスと推奨ワークフロー

実際に機能するもの: ✅ AIロジック生成 + 空のACDテンプレート + 手動開発

現実的な産業ワークフロー:

1. AIロジック生成: 「ジャム検出付きコンベヤ制御を作成」 → プロフェッショナルなラダーロジックコード

2. 空のACD作成: 開発準備完了のクリーンなプロジェクトテンプレート

3. 手動開発: Studio 5000にロジックをコピーし、MainProgram/MainTaskを手動で作成

4. 本番環境対応: AI支援を活用して開発された完全に機能するロジック

これが誠実かつ実用的である理由:

• ✅ 100%信頼性の高い空のACD作成 - 複雑な障害なし

• ✅ AI生成ロジックが機能 - 手動開発のための優れた基盤

• ✅ プロフェッショナルなワークフロー - AIが支援し、人間のエンジニアが検証・実装

• ✅ インポート問題ゼロ - 壊れたXMLやSDKの複雑な問題なし

高度な機能に関する現実的な評価:

• ⚠️ L5X生成: 構造は作成されるが、インポート前にXML修正が必要な場合あり

• ⚠️ 完全なACDプロジェクト: 実験的なSDK機能であり、失敗することが多い

• ✅ 高速検証: ロジックエラー検出に100%信頼性あり

• ✅ ベクトル検索: 既存プロジェクトの分析に最適

💡 使用例

MCPサーバーが設定されると、以下のような質問やコード生成が可能です:

🧠 AIコード生成の例

• 「スタートボタンが押されたらモーターを起動し、ストップボタンが押されたら停止するラダーロジックを作成」

• 「起動、停止、緊急停止機能を備えたコンベヤ制御システムを生成」

• 「ソレノイドバルブ用の5秒遅延タイマーを作成」

• 「自動/手動モードと運転時間カウンターを備えたポンプ制御用ラダーロジックを構築」

• 「インターロックと安全回路を備えた3ステーション組立ラインを設計」

📁 プロジェクト作成の例

• 「コンベヤ制御ロジックと安全インターロックを備えた完全な.ACDプロジェクトを作成」 → MainProgram + ロジックを含む完全な.ACD

• 「1756-L83Eコントローラー用のモーター制御.ACDプロジェクトを生成」 → すぐに使用できる.ACDファイル

• 「起動/停止機能を備えたモーター制御用の完全なStudio 5000 L5Xプロジェクトを作成」 → インポート用L5X

• 「安全インターロックを備えた3ステーション組立ライン用の完全なL5Xプロジェクトを構築」 → 複雑なL5Xプロジェクト

• 「手動開発用の空の.ACDテンプレートを作成」 → クリーンなテンプレートファイル

📚 ドキュメントの例

• 「Studio 5000で利用可能なタイマー命令は何ですか？」

• 「PID命令の完全な構文とパラメータを教えてください」

• 「利用可能なモーション制御命令はすべて何ですか？」

• 「ラダーロジックでGSV（システム値取得）命令をどのように使用しますか？」

• 「TON、TOF、RTOタイマー命令の違いは何ですか？」

🔍 検証の例

• 「このラダーロジックを検証してください: XIC(START)XIO(STOP)OTE(MOTOR)」

• 「TONタイマー命令の使用法がこれらのパラメータで正しいか確認してください」

• 「カウンターロジックがStudio 5000のベストプラクティスに従っているか検証してください」

🔍 L5X分析とベクトル検索の例

• 「既存のコンベヤプロジェクトでエンコーダーパルス計数ロジックを検索」

• 「L5Xファイル内のタイマーベースの故障検出パターンをすべて見つける」

• 「ソーター追跡ルーチンの複雑さを分析」

• 「既存のコンベヤールーチンにジャム検出ロジックを挿入する場所はどこですか？」

• 「本番L5Xファイル内のすべてのVFD速度制御ロジックを見つける」

• 「エンコーダーフィードバックシステムの依存関係マップを表示」

📚 SDKドキュメント検索の例

• 「LogixProject.partial_import_rungs_from_xml_fileメソッドの使用方法は？」

• 「タグ操作に利用可能なSDKメソッドはすべて何ですか？」

• 「プロジェクト作成にStudio 5000 SDKを使用する例を教えてください」

• 「ルーチン分析と変更に関連するSDK操作を見つける」

📐 技術図面分析の例

• 「Amazonコンベヤシステムプロジェクトの技術図面PDFをインデックス化」

• 「図面内のモーターM001へのすべての電気接続を見つける」

• 「コンベヤCV-001に関連するP&ID図を表示」

• 「図面内のダイバートゲートに示されている安全インターロックは何ですか？」

• 「ソーター追跡システムの制御ロジック図を見つける」

• 「ジャム検出センサーの配線と接続を図面から検索」

🏭 実世界のアプリケーション

• 「5つの連続ステップを持つ洗車システム用のラダーロジックを生成」

• 「コンベヤ制御と製品計数機能を備えた包装ライン用の完全なプロジェクトを作成」

• 「PIDループとアラーム処理を備えた温度制御システムを構築」

AIはMCPサーバーツールを自動的に使用して、実際のStudio 5000ドキュメントに基づいた正確で最新の情報を提供し、動作するPLCコードを生成します。

🔄 手動インポートワークフロー（推奨）

ステップバイステップ: 自然言語から動作するPLCコードへ

シナリオ: ジャム検出機能付きコンベヤ制御ロジックが必要

ステップ1: L5Xプロジェクトの生成

AIアシスタントに依頼:

「上流と下流のフォトアイを使用したジャム検出機能付きコンベヤ制御用の完全なL5Xプロジェクトを作成」

結果: 以下の内容を含む完全なL5Xファイル:

• ✅ MainProgramとMainTask

• ✅ プロフェッショナルなラダーロジック

• ✅ 説明付きの必要なタグすべて

• ✅ 検証済みの命令

ステップ2: Studio 5000へのインポート

1. Studio 5000を開く（既存プロジェクトまたは新規作成）

2. 移動: ファイル → インポート

3. 選択: 生成したL5Xファイル

4. 選択: MainProgramのインポート（または特定のコンポーネント）

5. クリック: インポート

6. 完了！ - テスト可能な動作ロジック

ステップ3: カスタマイズとテスト

• I/Oアドレスを生成されたタグにマッピング

• 特定のアプリケーションでロジックをテスト

• 要件に応じて必要に応じて修正

🏭 会社プロジェクト向け

• 既存の会社ACDテンプレートを使用

• 必要なロジックのみを生成

• 確立されたプロジェクト構造にインポート

• コーディング標準とプラクティスを維持

⚡ プロのヒント

• 異なるセクション（安全、プロセス、I/O）ごとに複数のL5Xファイルを生成

• 選択的にインポート - プログラムのみ、タグのみ、または特定のルーチンのみを選択

• バージョン管理に最適 - L5XファイルはGitとの相性が良い

• チームコラボレーション - 生成したL5Xファイルをチームメンバーと共有

トラブルシューティング

❗ 重大な問題

1. Pythonバージョンの不一致

問題: MCPサーバーは起動するが、SDK機能が動作しない、またはインポートエラーが発生する。

解決策:

# Check your Python version
python --version
# Must show 3.12.x

# If not 3.12, install Python 3.12 and use full path in Claude config:
"command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python312\\python.exe"

理由: Studio 5000 SDKは特にPython 3.12を必要とします。それ以前のバージョンではSDKのインポートが失敗します。

2. ドキュメントパスが見つからない

問題: 「メインインデックスファイルが見つかりません」または「命令が見つかりません」

解決策 - ドキュメントパスの特定:

1. ファイルエクスプローラーを開き、17691.htmを検索

2. 以下の一般的な場所を確認:

   C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm
   C:\Program Files\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm
   C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v37\Bin\Help\ENU\rs5000\17691.htm

3. 正しいパスを設定（ファイル名以外のすべて）:

   # Via environment variable
   set STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
   
   # Or via command line
   python src/mcp_server/studio5000_mcp_server.py --doc-root "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000" --test

3. SDKが利用できない

問題: 「Studio 5000 SDKが利用できません」または「SDKインポートに失敗しました」

最も一般的な原因: SDKホイールファイルをインストールしていません！ ⚠️

解決策:

1. 🚨 重要: 最初にSDKホイールファイルをインストール:

   # Find and install the wheel file (most teammates miss this step!)
   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

2. SDKインストールの確認:

   • C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\を確認

   • 存在しない場合は、SDKコンポーネントを含めてStudio 5000を再インストール

3. SDKが動作するか確認:

   # Test if SDK is now available
   python -c "import logix_designer_sdk; print('SDK OK')"

4. それでも失敗する場合は、SDKパスを設定:

   set STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python

⚠️ 一般的なセットアップの問題

4. サーバーが起動しない

症状: サーバーが即座にクラッシュする、またはJSON-RPCエラーが表示される。

解決策:

• Claude設定のPythonパスを確認 - Python 3.12へのフルパスを使用

• 作業ディレクトリを確認 - "cwd"はプロジェクトルートを指す必要があります

• ファイル権限を確認 - すべてのプロジェクトファイルへの読み取りアクセスを確保

• 単独でテスト:

  python src/mcp_server/studio5000_mcp_server.py --test

5. 環境変数が機能しない

問題: 環境変数を設定しても、サーバーがハードコードされたパスを使用し続ける。

解決策:

1. 環境変数設定後、コマンドプロンプト/IDEを再起動

2. 変数名を確認（大文字小文字を区別）:

   • STUDIO5000_DOC_PATH

   • STUDIO5000_SDK_PATH

   • PYTHON312_PATH

3. 環境変数をテスト:

   echo %STUDIO5000_DOC_PATH%
   echo %STUDIO5000_SDK_PATH%

6. Claude Desktop設定の問題

問題: MCPサーバーがClaude Desktopに表示されない。

解決策:

1. config.jsonの構文を確認 - JSONバリデーターを使用

2. 設定変更後、Claude Desktopを完全に再起動

3. 絶対パスを使用 - Claude設定では相対パスを使用しない

4. Claudeログを確認 - %APPDATA%\Claude\logs\内

🔧 高度なトラブルシューティング

高速検証: 100%信頼性、セットアップ不要

✅ 現在のステータス: 高速検証システム

システムは現在、即時の信頼性の高い結果を提供する本番対応の高速検証を使用しています:

高速検証が優れている理由:

• ✅ 即時結果: 0.001〜0.020秒の検証時間

• ✅ 100%信頼性: 外部依存関係やサービス要件なし

• ✅ 包括的なカバレッジ: 500以上のStudio 5000命令に対して検証

• ✅ セットアップ不要: どのシステムでも即座に動作

• ✅ 本番対応: すべての重大なPLCプログラミングエラーを検出

検証カバレッジ:

• ✅ 構文検証: 括弧のバランス、適切な命令形式

• ✅ 命令検証: 公式のStudio 5000命令セットに基づく

• ✅ 構造検証: ロジックパターンとベストプラクティス

• ✅ エラー報告: 行番号付きの詳細なエラーメッセージ

• ✅ 警告システム: 潜在的な問題と改善点を特定

複雑なセットアップはもう不要！

システムはSDK検証への依存から進化しました。高速検証は、セットアップの複雑さ、サービス依存関係、信頼性の問題なしに、プロフェッショナルなPLC開発に必要なすべてのエラー検出を提供します。

🔧 高度なトラブルシューティング

7. 複数のPythonバージョン

複数のPythonバージョンがインストールされている場合:

# Use specific Python 3.12 executable
C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe src/mcp_server/studio5000_mcp_server.py --test

# Or create virtual environment with Python 3.12
py -3.12 -m venv studio5000_env
studio5000_env\Scripts\activate
pip install -r requirements.txt

8. 企業/ネットワーク制限

問題: 権限によりドキュメントファイルにアクセスできない。

解決策:

• テスト時に管理者として実行

• PythonとStudio 5000ディレクトリのウイルス対策除外を確認

• Studio 5000がネットワーク共有にある場合はネットワークドライブアクセスを確認

9. Studio 5000バージョンの互換性

問題: v35以外のStudio 5000バージョンを使用している。

解決策:

• ドキュメントパスをバージョン（v37、v38など）に合わせて更新

• .ACDプロジェクト作成のmajor_revisionパラメータを更新

• SDKバージョンの互換性を確認

🧪 テストコマンド

以下のコマンドでセットアップを確認:

# Test 1: Python version
python --version

# Test 2: Basic server test
python src/mcp_server/studio5000_mcp_server.py --test

# Test 3: Documentation path
dir "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm"

# Test 4: SDK availability (after installing wheel file)
python -c "import logix_designer_sdk; print('SDK Available')"

# Test 5: Environment variables
echo %STUDIO5000_DOC_PATH%
echo %STUDIO5000_SDK_PATH%

📞 サポート

それでも問題が解決しない場合:

1. テストコマンドを実行し、完全な出力を取得

2. PythonバージョンとStudio 5000のインストールパスを確認

3. 問題を報告する前にすべてのファイルパスが存在することを確認

4. サポートを求める際は正確な設定を含める

サーバーのテスト

テスト手順については、上記のインストールガイドのステップ4を参照してください。

技術詳細

アーキテクチャ

MCPサーバーは4つの主要コンポーネントで構成されています:

1. ドキュメントパーサー (studio5000_mcp_server.py):

   • BeautifulSoupを使用してHTMLドキュメントファイルを解析

   • すべての命令のインメモリインデックスを構築

   • 命令名、カテゴリ、説明、構文、パラメータを抽出

   • 高速な検索と取得機能を提供

2. AIコードアシスタント (ai_assistant/code_assistant.py):

   • パターン認識による自然言語解析

   • 起動/停止、タイマー、カウンターパターンのラダーロジック生成

   • 適切なデータ型によるスマートタグ作成

   • ドキュメントデータベースを使用したコード検証

3. L5Xジェネレーター (code_generator/l5x_generator.py):

   • XMLベースのL5Xプロジェクトファイル生成

   • プログラム、ルーチン、タグを含む完全なプロジェクト構造

   • Studio 5000スキーマ準拠

   • 整形されたXML出力

4. Studio 5000 SDKインターフェース (sdk_interface/studio5000_sdk.py):

   • 公式Rockwell SDKを使用した実際の.ACDプロジェクト作成

   • SDK互換性のためのPython 3.12要件

   • 空のプロジェクトテンプレート生成

   • Studio 5000との直接統合

MCPプロトコル

• Model Context Protocol 仕様に準拠した AI 統合

• stdin/stdout を介した JSON-RPC 2.0 通信

• 15 以上の利用可能なツールを備えたツールベースのアーキテクチャ

• ベクトル駆動のセマンティック検索機能

• 本番規模の L5X ファイル解析

• すべての操作における非同期サポート

📁 プロジェクト構造

THE_Studio5000_AI_Assistant_V35/        # (folder name is whatever you clone it as)
├── setup.py                             # One-command installer — run this first
├── src/                                # Main source code
│   ├── mcp_server/
│   │   └── studio5000_mcp_server.py    # Main MCP server with AI features
│   ├── code_generator/
│   │   ├── l5x_generator.py            # L5X project file generation
│   │   └── templates/                  # L5X XML templates
│   ├── ai_assistant/                   # Enhanced AI assistance
│   │   ├── code_assistant.py           # AI-powered natural language processing
│   │   ├── enhanced_main_assistant.py  # Production-ready AI assistant
│   │   ├── mcp_integration.py          # MCP protocol integration
│   │   └── warehouse_automation_patterns.py # Industrial automation patterns
│   ├── sdk_interface/
│   │   └── studio5000_sdk.py           # Real Studio 5000 SDK integration
│   ├── documentation/                  # Vector-powered documentation search
│   │   ├── instruction_vector_db.py    # Instruction search vector database
│   │   └── instruction_mcp_integration.py # MCP tools for instruction search
│   ├── l5x_analyzer/                   # Advanced L5X file analysis
│   │   ├── l5x_vector_db.py           # L5X semantic search system
│   │   ├── l5x_mcp_integration.py     # L5X analysis MCP tools
│   │   └── sdk_powered_analyzer.py    # SDK-enhanced L5X analysis
│   ├── sdk_documentation/              # SDK documentation search
│   │   ├── sdk_vector_db.py           # SDK documentation vector search
│   │   ├── sdk_doc_parser.py          # SDK documentation parser
│   │   └── mcp_sdk_integration.py     # SDK documentation MCP tools
│   ├── tag_analyzer/                   # Tag analysis and management
│   │   ├── tag_vector_db.py           # Tag-based vector search
│   │   ├── csv_tag_parser.py          # CSV tag file parsing
│   │   └── tag_mcp_integration.py     # Tag analysis MCP tools
│   └── verification/                   # Code validation system
│       ├── sdk_verifier_clean.py      # Fast validation (production)
│       └── sdk_verifier.py           # Legacy SDK validation (deprecated)
├── *_vector_cache/                     # Vector database cache directories
│   ├── instruction_vector_cache/       # Instruction search cache
│   ├── l5x_vector_cache/              # L5X analysis cache
│   ├── sdk_vector_cache/              # SDK documentation cache
│   └── tag_vector_cache/              # Tag analysis cache
├── examples/                           # Example generated projects
├── docs/                              # Additional documentation
├── requirements.txt                    # Python dependencies (includes vector DB)
├── mcp_config.json                    # Sample MCP configuration for Claude
└── README.md                          # This comprehensive documentation

主要ファイル

• メインサーバー: src/mcp_server/studio5000_mcp_server.py(15 以上のツールを備えたメイン MCP サーバー)

• AI アシスタント: src/ai_assistant/enhanced_main_assistant.py(本番対応 AI アシスタント)

• L5X ジェネレーター: src/code_generator/l5x_generator.py(インポート可能な L5X ファイルを作成)

• L5X アナライザー: src/l5x_analyzer/l5x_vector_db.py(L5X ファイルのセマンティック検索)

• 高速検証: src/verification/sdk_verifier_clean.py(本番検証システム)

• SDK インターフェース: src/sdk_interface/studio5000_sdk.py(実際の .ACD ファイルを作成)

• ベクトルデータベース: *_vector_cache/ ディレクトリ(FAISS 搭載のセマンティック検索)

• 設定: 環境変数またはコマンドライン引数

コントリビューション

現在の機能 - 正直な評価

✅ 実際に動作するもの(本番対応):

• ✅ 公式 Studio 5000 ドキュメントの解析(ベクトル検索付き HTML)

• ✅ AI によるラダーロジックテキスト生成(手動開発のための優れた基盤)

• ✅ 空の .ACD ファイル作成(信頼性の高い SDK ベースのテンプレート生成)

• ✅ 高速検証システム(0.001 秒の応答、100% 信頼性)

• ✅ ベクトル駆動のセマンティック検索(FAISS ベース、本番規模)

• ✅ L5X ファイル解析(49,000 行以上のファイルでテスト済み)

• ✅ SDK ドキュメント検索(包括的なメソッドデータベース)

• ✅ パターン認識(起動/停止、タイマー、カウンターパターン)

⚠️ 部分的に動作するもの(手動修正が必要):

• ⚠️ L5X プロジェクトファイル生成(構造は作成するが RLL フォーマットに問題あり)

• ⚠️ 完全な ACD 作成(実験的な SDK 部分インポート機能)

• ⚠️ スマートコード挿入(解析は機能するが、挿入は SDK 依存)

🔧 開発が必要なもの:

• 🔧 適切な RLL XML 生成(現在は CDATA 内に生テキストを出力)

• 🔧 信頼性の高い SDK 部分インポート(複雑でエラーが発生しやすい)

• 🔧 エンドツーエンドのプロジェクト自動化(現在は手動ステップが必要)

今後の拡張機会

高優先度(完了済み! ✅):

• ✅ 完全な SDK 統合: 完了! プログラム/タスクの完全な作成を実装

• ✅ ルーチンのインポート/エクスポート: 完了! SDK の部分インポート機能を使用

• ✅ プログラム構造の作成: 完了! MainProgram と MainTask を自動的に作成

• タグ管理: SDK タグの作成および管理操作を実装(TODO)

• 高度なプロジェクト操作: ビルド、アップグレード、デプロイメントの自動化(TODO)

中優先度(機能拡張):

• 追加言語サポート: ストラクチャードテキスト(ST)およびファンクションブロックダイアグラム(FBD)の生成

• 拡張パターン認識: より複雑な産業オートメーションパターン

• ✅ SDK ドキュメントの改善: 完了! パーサーが 63 個の LogixProject メソッド + 39 個の例 = 102 以上の操作を検出(以前は 22 個)

• 高度な検証: 静的解析とベストプラクティスのチェック

低優先度(拡張統合):

• 複数の Studio 5000 バージョン: 動的なバージョン検出と互換性

• 統合拡張: FactoryTalk View、RSLinx、その他の Rockwell ツールのサポート

• クラウドデプロイメント: チームコラボレーションのための Web ベースのインターフェース

• キャッシュシステム: 大規模なドキュメントセットのパフォーマンス向上

🎯 正直な価値: AI 支援開発ワークフロー

このシステムは PLC 開発に貴重な AI 支援を提供します:

• ✅ AI ロジック生成: 自然言語をラダーロジックテキストに変換(良好に動作)

• ✅ 空の ACD テンプレート: 手動開発の準備が整ったクリーンなプロジェクトファイル(信頼性が高い)

• ⚠️ L5X 構造作成: フォーマット修正が必要な場合があるプロジェクトテンプレートを作成(部分的)

• ✅ 高速検証: 即時の構文および命令チェック(本番対応)

• ✅ ベクトル検索: 既存プロジェクトのセマンティック解析(本番対応)

質問できます: 「ジャム検出機能付きのコンベヤ制御ロジックを生成してください」 と入力すると、手動開発の基盤として使用できる高品質のラダーロジックコードが得られます。AI は支援しますが、最終的なソリューションの実装と検証は人間のエンジニアが行う必要があります。

開発環境のセットアップ

1. リポジトリをフォークする

2. Python 3.12 と依存関係をインストールする

3. Studio 5000 インストール用の環境変数を設定する

4. テストを実行して機能を検証する

5. 明確なドキュメントを添えてプルリクエストを送信する

ライセンスと法的情報

重要な法的情報:

• このプロジェクトは教育および開発目的で現状のまま提供されます

• Studio 5000、Logix Designer、ControlLogix、および Allen-Bradley は Rockwell Automation, Inc. の商標です

• 本ソフトウェアは Rockwell Automation とは提携しておらず、その承認も支援も受けていません

• SDK 機能を使用するには、ユーザーは有効な Studio 5000 ライセンスを保有している必要があります

• 生成されたコードとプロジェクトは、本番環境で使用する前に資格のある担当者による検証を受ける必要があります

免責事項: このツールは PLC プログラミングを支援しますが、産業オートメーションシステムに必要な適切なエンジニアリング慣行、安全解析、またはコンプライアンス検証に代わるものではありません。