공지:

이 저장소는 Studio 5000 AI Assistant의 v35 에디션 포크로, 독립적으로 유지관리됩니다. 기본값은 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 휠 파일을 찾으면 설치하고, 사용자 머신에 맞는 올바른 경로로 바로 사용 가능한 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-ignored 처리됩니다 — 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 휠 설치, 설정 파일 생성을 한 번에 처리합니다 — 위의 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 파일에 대한 시맨틱 검색 (49k+ 라인으로 테스트됨)

• 프로덕션 규모 처리: 복잡한 산업 자동화 프로젝트 처리

• 스마트 코드 삽입: 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 휠 파일 찾기:

   # 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 휠 파일 설치:

   # 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. 대안 - 휠 파일을 찾을 수 없는 경우:

   # 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 휠 파일을 올바르게 설치한 경우)

   • ✅ "SDK Available: False" (SDK 설치를 건너뛴 경우 정상 - L5X 생성은 여전히 작동)

   • ✅ 샘플 검색 결과 및 코드 생성 테스트

3. SDK Available이 False로 표시되는데 휠 파일을 설치했다면:

   • 휠 파일 경로가 올바른지 확인

   • 시도: 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 설정(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 (선택적 문자열): 유형별 필터 (method, class, enum, example)

출력: 예제와 매개변수가 포함된 상세 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 (선택적 문자열): 유형별 필터 (electrical, pid, logic, io_list)

• equipment_filter (선택적 문자열): 장비 태그별 필터

출력: 도면 컨텍스트와 페이지 참조가 포함된 순위 검색 결과

18. 장비 컨텍스트 찾기

도구: find_equipment_context 매개변수:

• equipment_tag (문자열): 장비 식별자 (예: "M001", "CV-001")

• context_type (선택적 문자열): 필요한 컨텍스트 유형 (electrical, process, safety)

기능: 특정 장비와 관련된 모든 도면 및 문서 찾기

🎯 PLC 프로젝트 생성을 위한 세 가지 강력한 접근 방식

MCP 서버는 각각 다른 사용 사례에 최적화된 세 가지 접근 방식으로 PLC 프로젝트 생성을 지원합니다:

🥇 접근 방식 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. %APPDATA%\Claude\logs\에서 Claude 로그를 확인하세요

🔧 고급 문제 해결

빠른 검증: 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 서버는 네 가지 주요 구성 요소로 구성됩니다:

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 프로토콜

• AI 통합을 위한 Model Context Protocol 사양을 따릅니다

• 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 도구 지원

• 클라우드 배포: 팀 협업을 위한 웹 기반 인터페이스

• 캐싱 시스템: 대규모 문서 세트에 대한 성능 개선

🎯 솔직한 가치: 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 프로그래밍을 지원하지만 산업 자동화 시스템에 필요한 적절한 엔지니어링 관행, 안전 분석 또는 규정 준수 검증을 대체하지 않습니다.