nader0913/ocpp-rag

OCPP RAG is a knowledge base server that connects to Claude and other AI assistants, giving them detailed information about the protocols used by electric vehicle charging stations. OCPP, short for Open Charge Point Protocol, is the industry standard that defines how a charging station communicates with the software system that manages it. This project indexes the official specification documents and makes them searchable so an AI can answer technical questions about how charging stations work. The server holds over 3,500 indexed text chunks drawn from 18 official documents, including both OCPP 1.6 and OCPP 2.0.1 specifications, whitepapers on security, Plug and Charge support for the ISO 15118 standard, and California pricing requirements. It also includes 119 structured use cases (covering scenarios like cold boot, authorization, smart charging, and transaction handling), 128 message format schemas, and 146 diagrams showing sequence flows, network topologies, and security hierarchies. Once installed, you can ask questions like how cold boot works, what the JSON format for a specific message looks like, how authorization changed between the two protocol versions, or which device variables are available for a charging station component. The server exposes nine tools that the AI can call: semantic search across all documents, detailed use-case lookup by ID, schema retrieval by message name, figure browsing and display, version comparison, and document listing. Installation adds the server to Claude Code or Claude Desktop with a single command. On first run it builds a local search index using ChromaDB, which takes about 30 seconds. The index is cached so subsequent startups are fast. The cache location can be changed with an environment variable. The license allows free use for personal projects, research, education, non-profits, and government institutions. Commercial use requires a separate paid license.