How seagetch/mcp-receiver works
Project type and purpose
• This is an open-source network proxy/receiver tool written in Python.
• Its goal is to listen for mocopi motion-tracking UDP packets on port 12351 (from the Mocopi mobile app or BVHSender) and forward them as VMC Protocol packets to a consumer on localhost:39540.
File structure
• Top-level files:
• LICENSE, README.md, requirements.txt
• Documentation:
• doc/Protocol.md (spec of the mocopi protocol)
• doc/mcp-format.odp (presentation of the packet format)
• Core package: mcp_receiver/
• __main__.py – module entry point (invoked by python3 -m mcp_receiver)
• runner.py – orchestrates startup, configures ports and modules
• receiver.py – receives and decodes incoming mocopi packets
• vmcsender.py – encodes and sends VMC Protocol packets
• dumper.py – optional packet logger/debug dumper
• dummyreceiver.py – stub for testing or alternative input
• Tests: test/test.py – validates end-to-end packet flow
README insights
• Highlights two external systems: mocopi mobile app (or BVHSender) and the VMC Protocol consumer.