How nxt-tronic/winols-mcp works
winols-mcp is an MCP-to-WinOLS control bridge, not a standalone ECU editor. An MCP client invokes a tool; the Python server validates and marshals the request into a ticket, the Lua script running inside WinOLS polls for it and calls WinOLS, then returns a response ticket for the server to deliver. The catalog covers the documented project, calibration, checksum, map, import/export, and context operations. The README documents this flow; the Lua implementation was not excerpted, so its internal behavior is represented only where explicitly documented.
Main entry points: winols_mcp_server.py Python MCP Server · winols_mcp_bridge.lua Lua Bridge · tool_specs.py Tool Catalog
Components 15
MCP Interface
- Python MCP Server
server/winols_mcp_server.py - Tool Catalog
server/tool_specs.py
Ticket Bridge
- Ticket Files
- Lua Bridge
lua/winols_mcp_bridge.lua
WinOLS Capabilities
- Session Control
server/tool_specs.py - Project Lifecycle
server/tool_specs.py - Calibration Data
server/tool_specs.py - Checksum Operations
server/tool_specs.py - Map Management
server/tool_specs.py - Import Export
server/tool_specs.py - Vehicle and Version Data
server/tool_specs.py - Search and Addressing
server/tool_specs.py - Filesystem and Diagnostics
server/tool_specs.py
Other components
- MCP Client
- WinOLS
Connections 16
- MCP Client → Python MCP Server: calls tools
README.md - Python MCP Server → Tool Catalog: builds tools
server/winols_mcp_server.py - Python MCP Server → Ticket Files: writes requests
README.md - Lua Bridge → Ticket Files: polls requests
README.md - Lua Bridge → WinOLS: calls API
README.md - Lua Bridge → Ticket Files: writes responses
README.md - Python MCP Server → Ticket Files: polls responses
server/winols_mcp_server.py - Python MCP Server → Session Control: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Project Lifecycle: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Calibration Data: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Checksum Operations: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Map Management: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Import Export: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Vehicle and Version Data: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Search and Addressing: dispatches tools
server/winols_mcp_server.py - Python MCP Server → Filesystem and Diagnostics: dispatches tools
server/winols_mcp_server.py