Smart Metrix MCP Server

Smart Metrix is the utility-metering platform behind the water meters IoT-Exponenta installs. It has a large REST API and no good way to ask it a question in plain language. This is an MCP server that puts 49 read-only tools in front of it, so Claude can answer things like which gateways went quiet this week without anyone opening the admin panel.

Everything is a GET. There are no commands, no valve control, no writes — an assistant hooked up to a live metering system should not be able to change anything, and the simplest way to guarantee that is to never give it the verbs.

There are two servers in the repo, and they solve the same problem in opposite ways. The Node one reads the Swagger file at startup and generates its tool schemas from it, walking the OpenAPI parameter types into Zod. The Python one is 49 hand-written functions with real signatures and Russian docstrings — more work up front, but the descriptions the model actually reads are written for the model rather than inherited from the spec. The Python server is the one I'd deploy.

It's a working prototype, last touched in June. One thing I'd fix before anyone else runs it: the API token is committed in the Python file.