FluxMcp

FluxMcp adds an MCP (Model Context Protocol) server to handle ProtoFlux for AI integration within Resonite via the Resonite Mod Loader. This server runs as a .NET Mod (FluxMcp.dll) loaded by the game through RML, and exposes a TCP-based API that tools and AI clients can connect to for context-aware interactions. By default the TCP server is enabled and listens on a configurable address and port; these can be adjusted in the in-game configuration to suit your network environment. Once running, clients can query and send ProtoFlux data to the server to enable AI components to understand and interact with model context in Flux-enabled environments. Use the FluxMcp tooling within your AI pipelines to serialize/deserialize ProtoFlux payloads and manage session contexts.

Prerequisites:

• Resonite Mod Loader (RML) installed and configured.
• Internet access to download needed components if required by the mod package.

Installation steps:

1. Install Resonite Mod Loader by following its official guide and ensure rml_mods directory is created (e.g., C:\Program Files (x86)\Steam\steamapps\common\Resonite\rml_mods).
2. Download FluxMcp.dll from the official FluxMcp release page and place it into the rml_mods folder:
   • Destination (example): C:\Program Files (x86)\Steam\steamapps\common\Resonite\rml_mods\FluxMcp.dll
3. If there is a bundled library package (e.g., rml_libs) from FluxMcp releases, extract and place the rml_libs folder into the Resonite installation directory:
   • Destination (example): C:\Program Files (x86)\Steam\steamapps\common\Resonite\rml_libs
4. Start or restart Resonite. The FluxMcp mod will initialize and the MCP server will start according to its configuration. You can verify the mod is loaded by checking Resonite logs after launch.

Notes:

• Ensure FluxMcp.dll is accessible in the rml_mods folder and that the corresponding rml_libs (if required) are present to satisfy dependencies.
• If you modify configuration, restart the game/engine to apply changes.

Tips and common issues:

• The server defaults to Enabled by in-game settings; if you don’t see a connection, verify that the mod loaded correctly in the game logs.
• If you need to adjust Bind address or Listen port, modify the FluxMcp configuration in the mod’s settings and restart the game to apply changes.
• Ensure that your firewall allows inbound connections on the configured port if you’re connecting clients from other machines.
• Logs can help diagnose issues with ProtoFlux payload handling; check the Resonite logs for FluxMcp-related entries.
• This MCP server is designed to integrate ProtoFlux with AI workflows; ensure your AI tooling is compatible with the ProtoFlux version supported by FluxMcp.