# rivie13/studio5000-ai-assistant architecture

> Architecture diagram of the GitHub repository rivie13/studio5000-ai-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rivie13/studio5000-ai-assistant
- Repository: https://github.com/rivie13/studio5000-ai-assistant

## Overview

This prototype is an MCP server for Studio 5000 PLC assistance. The principal workflow is an AI client requesting code or project operations, with the server routing requests to generation, validation, and project tools. Separate branches provide semantic search over L5X projects, drawings, tags, and SDK documentation. The graph also preserves the documented instruction-search capability. Relationships come from sampled source excerpts, SOURCE INDEX references, and README statements; unsampled implementation details are not assumed.

Main entry points: [`src/mcp_server/studio5000_mcp_server.py`](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/mcp_server/studio5000_mcp_server.py) (MCP Server), [`src/ai_assistant/enhanced_main_assistant.py`](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_main_assistant.py) (Main Assistant), [`src/ai_assistant/enhanced_ladder_generator.py`](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_ladder_generator.py) (Ladder Generator), [`src/l5x_analyzer/l5x_mcp_integration.py`](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/l5x_mcp_integration.py) (L5X MCP Tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP Entry"]
  node_server["MCP Server"]
end

subgraph group_generation["PLC Generation"]
  node_assistant["Main Assistant"]
  node_ladder["Ladder Generator"]
  node_codeassist["Code Assistant"]
  node_patterns["Automation Patterns"]
  node_l5xgen["L5X Generator<br/>[l5x_generator.py]"]
  node_sdk["Studio 5000 SDK<br/>[studio5000_sdk.py]"]
  node_verifier["SDK Verifier<br/>[sdk_verifier.py]"]
end

subgraph group_project["Project Analysis"]
  node_l5x_mcp["L5X MCP Tools"]
  node_l5x_db[("L5X Vector DB<br/>[l5x_vector_db.py]")]
  node_l5x_analyzer["SDK L5X Analyzer"]
  node_l5x_chunks["L5X Chunks<br/>[l5x_chunk.py]"]
  node_pdf_tools["Drawing Tools"]
  node_pdf_parser["PDF Parser<br/>[pdf_parser.py]"]
  node_pdf_db[("Drawing Vector DB<br/>[pdf_vector_db.py]")]
  node_tag_tools["Tag Tools"]
  node_tag_parser["CSV Tag Parser<br/>[csv_tag_parser.py]"]
  node_tag_db[("Tag Vector DB<br/>[tag_vector_db.py]")]
  node_tag_chunks["Tag Chunks<br/>[tag_chunk.py]"]
end

subgraph group_knowledge["Search Knowledge"]
  node_instruction_search["Instruction Search"]
  node_sdk_docs["SDK Docs Tools"]
  node_sdk_parser["SDK Doc Parser<br/>[sdk_doc_parser.py]"]
  node_sdk_db[("SDK Docs Vector DB<br/>[sdk_vector_db.py]")]
end

node_user(("AI Client"))

node_user -->|"requests tools"| node_server
node_server -->|"routes generation"| node_assistant
node_assistant -->|"generates logic"| node_ladder
node_assistant -->|"uses assistance"| node_codeassist
node_ladder -->|"matches patterns"| node_patterns
node_ladder -->|"uses mappings"| node_codeassist
node_server -->|"creates L5X"| node_l5xgen
node_server -->|"creates ACD"| node_sdk
node_server -->|"validates SDK"| node_verifier
node_server -->|"routes analysis"| node_l5x_mcp
node_l5x_mcp -->|"searches projects"| node_l5x_db
node_l5x_mcp -->|"requests analysis"| node_l5x_analyzer
node_l5x_db -->|"extracts content"| node_l5x_analyzer
node_l5x_db -->|"indexes chunks"| node_l5x_chunks
node_l5x_analyzer -->|"creates chunks"| node_l5x_chunks
node_server -->|"routes drawing search"| node_pdf_tools
node_pdf_tools -->|"searches drawings"| node_pdf_db
node_pdf_tools -->|"uses parsing"| node_pdf_parser
node_pdf_db -->|"indexes parsed data"| node_pdf_parser
node_server -->|"routes tag search"| node_tag_tools
node_tag_tools -->|"parses exports"| node_tag_parser
node_tag_tools -->|"searches tags"| node_tag_db
node_tag_parser -->|"creates chunks"| node_tag_chunks
node_tag_db -->|"indexes chunks"| node_tag_chunks
node_server -->|"routes instruction search"| node_instruction_search
node_server -->|"routes SDK search"| node_sdk_docs
node_sdk_docs -->|"parses documentation"| node_sdk_parser
node_sdk_docs -->|"searches documentation"| node_sdk_db
node_sdk_db -->|"indexes parsed docs"| node_sdk_parser

click node_server "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/mcp_server/studio5000_mcp_server.py"
click node_assistant "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_main_assistant.py"
click node_ladder "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_ladder_generator.py"
click node_codeassist "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_code_assistant.py"
click node_patterns "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/warehouse_automation_patterns.py"
click node_l5xgen "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/code_generator/l5x_generator.py"
click node_sdk "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_interface/studio5000_sdk.py"
click node_verifier "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/verification/sdk_verifier.py"
click node_l5x_mcp "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/l5x_mcp_integration.py"
click node_l5x_db "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/l5x_vector_db.py"
click node_l5x_analyzer "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/sdk_powered_analyzer.py"
click node_l5x_chunks "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/l5x_chunk.py"
click node_pdf_tools "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/drawings_analyzer/pdf_mcp_integration.py"
click node_pdf_parser "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/drawings_analyzer/pdf_parser.py"
click node_pdf_db "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/drawings_analyzer/pdf_vector_db.py"
click node_tag_tools "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/tag_mcp_integration.py"
click node_tag_parser "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/csv_tag_parser.py"
click node_tag_db "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/tag_vector_db.py"
click node_tag_chunks "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/tag_chunk.py"
click node_instruction_search "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/documentation/instruction_mcp_integration.py"
click node_sdk_docs "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_documentation/mcp_sdk_integration.py"
click node_sdk_parser "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_documentation/sdk_doc_parser.py"
click node_sdk_db "https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_documentation/sdk_vector_db.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_user toneBlue
class node_assistant,node_ladder,node_codeassist,node_patterns,node_l5xgen,node_sdk,node_verifier toneAmber
class node_l5x_mcp,node_l5x_db,node_l5x_analyzer,node_l5x_chunks,node_pdf_tools,node_pdf_parser,node_pdf_db,node_tag_tools,node_tag_parser,node_tag_db,node_tag_chunks toneMint
class node_instruction_search,node_sdk_docs,node_sdk_parser,node_sdk_db toneRose
```

## Components

### MCP Entry

- [MCP Server](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/mcp_server/studio5000_mcp_server.py): `src/mcp_server/studio5000_mcp_server.py`

### PLC Generation

- [Main Assistant](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_main_assistant.py): `src/ai_assistant/enhanced_main_assistant.py`
- [Ladder Generator](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_ladder_generator.py): `src/ai_assistant/enhanced_ladder_generator.py`
- [Code Assistant](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/enhanced_code_assistant.py): `src/ai_assistant/enhanced_code_assistant.py`
- [Automation Patterns](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/ai_assistant/warehouse_automation_patterns.py): `src/ai_assistant/warehouse_automation_patterns.py`
- [L5X Generator](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/code_generator/l5x_generator.py): `src/code_generator/l5x_generator.py`
- [Studio 5000 SDK](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_interface/studio5000_sdk.py): `src/sdk_interface/studio5000_sdk.py`
- [SDK Verifier](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/verification/sdk_verifier.py): `src/verification/sdk_verifier.py`

### Project Analysis

- [L5X MCP Tools](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/l5x_mcp_integration.py): `src/l5x_analyzer/l5x_mcp_integration.py`
- [L5X Vector DB](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/l5x_vector_db.py): `src/l5x_analyzer/l5x_vector_db.py`
- [SDK L5X Analyzer](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/sdk_powered_analyzer.py): `src/l5x_analyzer/sdk_powered_analyzer.py`
- [L5X Chunks](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/l5x_analyzer/l5x_chunk.py): `src/l5x_analyzer/l5x_chunk.py`
- [Drawing Tools](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/drawings_analyzer/pdf_mcp_integration.py): `src/drawings_analyzer/pdf_mcp_integration.py`
- [PDF Parser](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/drawings_analyzer/pdf_parser.py): `src/drawings_analyzer/pdf_parser.py`
- [Drawing Vector DB](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/drawings_analyzer/pdf_vector_db.py): `src/drawings_analyzer/pdf_vector_db.py`
- [Tag Tools](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/tag_mcp_integration.py): `src/tag_analyzer/tag_mcp_integration.py`
- [CSV Tag Parser](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/csv_tag_parser.py): `src/tag_analyzer/csv_tag_parser.py`
- [Tag Vector DB](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/tag_vector_db.py): `src/tag_analyzer/tag_vector_db.py`
- [Tag Chunks](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/tag_analyzer/tag_chunk.py): `src/tag_analyzer/tag_chunk.py`

### Search Knowledge

- [Instruction Search](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/documentation/instruction_mcp_integration.py): `src/documentation/instruction_mcp_integration.py`
- [SDK Docs Tools](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_documentation/mcp_sdk_integration.py): `src/sdk_documentation/mcp_sdk_integration.py`
- [SDK Doc Parser](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_documentation/sdk_doc_parser.py): `src/sdk_documentation/sdk_doc_parser.py`
- [SDK Docs Vector DB](https://github.com/rivie13/studio5000-ai-assistant/blob/main/src/sdk_documentation/sdk_vector_db.py): `src/sdk_documentation/sdk_vector_db.py`

### Other components

- **AI Client**

## Connections

- AI Client → MCP Server: requests tools (evidence: `README.md`)
- MCP Server → Main Assistant: routes generation (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- Main Assistant → Ladder Generator: generates logic (evidence: `src/ai_assistant/enhanced_main_assistant.py`)
- Main Assistant → Code Assistant: uses assistance (evidence: `src/ai_assistant/enhanced_main_assistant.py`)
- Ladder Generator → Automation Patterns: matches patterns (evidence: `src/ai_assistant/enhanced_ladder_generator.py`)
- Ladder Generator → Code Assistant: uses mappings (evidence: `src/ai_assistant/enhanced_ladder_generator.py`)
- MCP Server → L5X Generator: creates L5X (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- MCP Server → Studio 5000 SDK: creates ACD (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- MCP Server → SDK Verifier: validates SDK
- MCP Server → L5X MCP Tools: routes analysis (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- L5X MCP Tools → L5X Vector DB: searches projects (evidence: `src/l5x_analyzer/l5x_mcp_integration.py`)
- L5X MCP Tools → SDK L5X Analyzer: requests analysis (evidence: `src/l5x_analyzer/l5x_mcp_integration.py`)
- L5X Vector DB → SDK L5X Analyzer: extracts content (evidence: `src/l5x_analyzer/l5x_vector_db.py`)
- L5X Vector DB → L5X Chunks: indexes chunks (evidence: `src/l5x_analyzer/l5x_vector_db.py`)
- SDK L5X Analyzer → L5X Chunks: creates chunks (evidence: `src/l5x_analyzer/sdk_powered_analyzer.py`)
- MCP Server → Drawing Tools: routes drawing search (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- Drawing Tools → Drawing Vector DB: searches drawings (evidence: `src/drawings_analyzer/pdf_mcp_integration.py`)
- Drawing Tools → PDF Parser: uses parsing (evidence: `src/drawings_analyzer/pdf_mcp_integration.py`)
- Drawing Vector DB → PDF Parser: indexes parsed data (evidence: `src/drawings_analyzer/pdf_vector_db.py`)
- MCP Server → Tag Tools: routes tag search (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- Tag Tools → CSV Tag Parser: parses exports (evidence: `src/tag_analyzer/tag_mcp_integration.py`)
- Tag Tools → Tag Vector DB: searches tags (evidence: `src/tag_analyzer/tag_mcp_integration.py`)
- CSV Tag Parser → Tag Chunks: creates chunks (evidence: `src/tag_analyzer/csv_tag_parser.py`)
- Tag Vector DB → Tag Chunks: indexes chunks (evidence: `src/tag_analyzer/tag_vector_db.py`)
- MCP Server → Instruction Search: routes instruction search (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- MCP Server → SDK Docs Tools: routes SDK search (evidence: `src/mcp_server/studio5000_mcp_server.py`)
- SDK Docs Tools → SDK Doc Parser: parses documentation (evidence: `src/sdk_documentation/mcp_sdk_integration.py`)
- SDK Docs Tools → SDK Docs Vector DB: searches documentation (evidence: `src/sdk_documentation/mcp_sdk_integration.py`)
- SDK Docs Vector DB → SDK Doc Parser: indexes parsed docs (evidence: `src/sdk_documentation/sdk_vector_db.py`)
